Skip to main content
POST
cURL

Body

application/x-www-form-urlencoded

OAuth form.

grant_type
enum<string>
required

Grant type. Always client_credentials.

Available options:
client_credentials
Minimum string length: 1
client_id
string
required

OAuth Client ID assigned by BillBuddy. Submit as a string.

Minimum string length: 1
client_secret
string
required

OAuth Client Secret. Store only on the merchant server.

Minimum string length: 1
scope
string
default:""

Optional space-separated scopes. Usually omitted or an empty string.

Response

Token issued successfully.

Standard OAuth success response. Does not contain code/message/data and does not return refresh_token.

token_type
enum<string>
required

Always Bearer.

Available options:
Bearer
expires_in
integer
required

Token lifetime in seconds. Use the actual response; the example is 7200 seconds.

access_token
string
required

OAuth access_token. Include it in the Authorization: Bearer header on subsequent requests.