Create an organization

post

https://gateway.stage.bill.com/connect/v3/partner/organizations

Create a new organization.

This operation requires partner-level permissions.

A sessionId header value generated with API partner login
An appKey header value

See Organizations for BILL partners in the Guides section for more information, sample requests, and responses.

Body Params

name

string

required

length between 1 and 100

Organization name

address

object

required

Organization physical address

mailingAddress

object

Organization mailing address

phone

string

Organization phone number

companyOwner

object

Company owner information.

Note: It is important that you set the company owner name when you create an organization. This helps the organization user to get through the risk verification and add funding account steps without errors.

taxId

string

Organization tax ID. This value is required by the IRS for tax purposes.

taxIdType

string

enum

Organization tax ID type

Allowed:

industry

string

length ≤ 500

Organization industry

businessCategory

string

enum

Organization business category

accountType

string

enum

Organization account type

Allowed:

processingOptions

object

Organization processing options

Headers

sessionId

string | null

API session ID generated with /v3/partner/login

appKey

string | null

Application key sent to you by BILL when you create a partner account

Responses

Language

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Create an organization response

4XXList of errors.

5XXList of errors.