API sign in

Sign in to your BILL developer account with the POST /v3/login API endpoint. The required fields for signing in are username, password, organizationId, and devKey.

Sign in credentialsDescription
UsernameYour username is the email address used to sign in to your BILL developer account.
PasswordYour password is used to sign in to your BILL developer account.
Organization IDYour BILL developer account represents your organization in BILL. The organization ID is a unique alphanumeric value that begins with 008.
Developer keyYour developer key is used to identify your developer account in your API requests.

📘

NOTE

The header value in the v3 API requests is content-type: application/json.

Sample request

In this cURL example, you sign in to your BILL developer account in the API sandbox environment with POST /v3/login. See Development environments for information about the API sandbox and production environments.

curl --request POST \
--url 'https://gateway.sandbox.bill.com/connect/v3/login' \
--header 'content-type: application/json' \
--data '{
  "username": "{username}", 
  "password": "{password}",
  "organizationId": "{organization_id}", 
  "devKey": "{developer_key}"
}'

In the response, your API session is created and a generated sessionId is available. Use the sessionId in all subsequent API calls to confirm that you are in a signed-in API session. See API login for more information.