Accounts
No OAuth-enabled endpoints in this section. Turn off the OAuth filter in the sidebar to see all of its endpoints.
Account Management APIs
Create Account
The externalId parameter is meant to be used as an external reference to the system that the account is being created from, it is required if Single Sign-On is enabled where it will be used to match the incoming NameID in SAML (or Subject in OIDC) to the correct Account (more on that can be found in Single Sign On section of the documentation).If the SEPA integration is enabled for the Provider, and the sepaAccepted parameter is provided, a SEPA Direct Debit mandate email will be sent to the account's billing email.
User sessionAPI credentialaccounts:writeRequest bodyapplication/json
accountTierBillingPlanRequestsobject[]
billingobject
autopaymanualautopayfalsecontactobject
femalemalecreditBillingobject
fieldServiceobject
-1max 5201Account Created application/json
dataAccountResource
billingAccountBillingDetail
autopaymanualpayBridgecontactAccountContactDetail
metaobject
400Invalid Request application/json
errorobject
401Unauthorized application/json
errorobject
403Forbidden: missing a required permission, or no access to this resource application/json
errorobject
404Not Found application/json
errorobject
500Internal server error application/json
errorobject
Search Accounts
The search for accounts is driven by an index and eventually consistent. That means that an update to accounts may take a short while before it is reflected in search results.
User sessionAPI credentialaccounts:readRequest bodyapplication/json
createdAtobject
falsefalse50false0sortobjectdefault {"field":"createdAt","order":"desc"}
{"field":"createdAt","order":"desc"}ascdesc200OK application/json
dataAccountResource[]
billingAccountBillingDetail
autopaymanualpayBridgecontactAccountContactDetail
metaobject
400Invalid Request application/json
errorobject
401Unauthorized application/json
errorobject
403Forbidden: missing a required permission, or no access to this resource application/json
errorobject
404Not Found application/json
errorobject
500Internal server error application/json
errorobject
Get Account
To access billing information for accounts (debit & credit billing), the user or credential making the API call must have the accounts-billing:read permissions.
User sessionAPI credentialaccounts:readPath parameters1
200Account application/json
dataAccountResource
billingAccountBillingDetail
autopaymanualpayBridgecontactAccountContactDetail
metaobject
400Invalid Request application/json
errorobject
401Unauthorized application/json
errorobject
403Forbidden: missing a required permission, or no access to this resource application/json
errorobject
404Not Found application/json
errorobject
500Internal server error application/json
errorobject
Update Account
Updates Account with partial data. When updating or modifying billing data for account objects, the calling user or credential must possess a accounts-billing:read-write permission. This permission allows the user to make changes to the billing information associated with the specific account entity.
User sessionAPI credentialaccounts:writePath parameters1
Request bodyapplication/json
accountTierBillingPlanRequestsobject[]
billingobject
autopaymanualautopayfalsecontactobject
femalemalecreditBillingobject
fieldServiceobject
installerPartnerProgramobject
suboperatorSettingsobject
-1max 5200Account application/json
dataAccountResource
billingAccountBillingDetail
autopaymanualpayBridgecontactAccountContactDetail
metaobject
400Invalid Request application/json
errorobject
401Unauthorized application/json
errorobject
403Forbidden: missing a required permission, or no access to this resource application/json
errorobject
404Not Found application/json
errorobject
500Internal server error application/json
errorobject
Soft delete Account
User sessionAPI credentialaccounts:writePath parameters1
204Account deleted text/plain
400Invalid Request application/json
errorobject
401Unauthorized application/json
errorobject
403Forbidden: missing a required permission, or no access to this resource application/json
errorobject
404Not Found application/json
errorobject
500Internal server error application/json
errorobject
Restore soft deleted Account
User sessionAPI credentialaccounts:write