BIbill
partner

Create an organization

Changed on

Create a new organization.

This operation requires partner-level permissions.

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

post/v3/partner/organizations

Request

  • Base URL
    https://gateway.stage.bill.com/connect
  • URL
    https://gateway.stage.bill.com/connect/v3/partner/organizations
  • Auth
    none declared

Headers

sessionIdstring nullable

API session ID generated with /v3/partner/login

Example:{{partner_session_id}}
appKeystring nullable

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

Example:{{app_key}}

Request body

namestring required

Organization name

displayNamestring

Organization display name (DBA trade name)

phonestring

Organization phone number

taxIdstring

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

taxIdType'EIN' | 'SSN'

Organization tax ID type

industrystring

Organization industry

businessCategory'CORPORATION' | 'LLC' | 'NON_PROFIT' | 'GOVERNMENT' | 'SOLE_PROPRIETOR' | 'INDIVIDUAL' | 'TRUST' | 'UNKNOWN'

Organization business category

accountType'BUSINESS' | 'CONTRACTOR' | 'EMPLOYEE_OR_INDIVIDUAL' | 'OTHER' | 'CONSUMER'

Organization account type

Example request

{
  "name": "Rice Cakes Inc",
  "address": {
    "line1": "987 Home St",
    "city": "San Jose",
    "stateOrProvince": "CA",
    "zipOrPostalCode": "95002",
    "country": "US"
  },
  "phone": "{{org_phone_no}}",
  "taxId": "999888777",
  "taxIdType": "EIN",
  "companyOwner": {
    "name": "Noodle Soupsmith",
    "dateOfBirth": "1985-01-01"
  },
  "industry": "Restaurant Caterer or Bar",
  "businessCategory": "LLC",
  "accountType": "BUSINESS",
  "processingOptions": {
    "mailingAddressSameAsPhysical": "true"
  }
}

Response

Create an organization response

idstring

BILL-generated ID of the organization. The value begins with 008.

archivedboolean

Set as true if the organization is archived. You cannot archive an organization with the API.

namestring

Organization name

displayNamestring

Organization display name (DBA trade name)

phonestring

Organization phone number

taxIdstring

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

taxIdType'EIN' | 'SSN' | 'UNDEFINED'

Organization tax ID type.

industrystring

Organization industry

businessCategory'UNDEFINED' | 'CORPORATION' | 'LLC' | 'NON_PROFIT' | 'GOVERNMENT' | 'SOLE_PROPRIETOR' | 'INDIVIDUAL' | 'TRUST' | 'UNKNOWN'

Organization business category.

accountType'BUSINESS' | 'CONTRACTOR' | 'EMPLOYEE_OR_INDIVIDUAL' | 'OTHER' | 'CONSUMER' | 'UNDEFINED'

Organization account type.

partnerNamestring

Partner name.

This field is available only when select BILL partners create an organization. Partner name is part of the information that BILL uses to identify partners.

createdTimestring date-time

Created date and time

updatedTimestring date-time

Updated date and time

Changes

  • 54edddceb0a5Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status