Skip to main content
POST
/
managed_accounts
Create managed account
curl --request POST \
  --url https://api.vantage.sh/v2/managed_accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "contact_email": "<string>",
  "access_credential_tokens": [
    "<string>"
  ],
  "billing_rule_tokens": [
    "<string>"
  ],
  "email_domain": "<string>"
}
'
{
  "token": "acct_ace620fc3d602740",
  "name": "New Managed Account",
  "contact_email": "admin@acme.com",
  "parent_account_token": "acct_e6baa6dcf81b4e20",
  "access_credential_tokens": [
    "accss_crdntl_72a8c8ab1d6c9d2c"
  ],
  "billing_rule_tokens": [],
  "email_domain": null
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Create a Managed Account.

​
name
string
required

The name of the Managed Account.

​
contact_email
string
required

The contact email address for the Managed Account.

​
access_credential_tokens
string[]

Access Credential (aka Integrations) tokens to assign to the Managed Account.

​
billing_rule_tokens
string[]

Billing Rule tokens to assign to the Managed Account.

​
email_domain
string

Email domain to associate with this Managed Account for SSO.

Response

ManagedAccount model

​
token
string
required
​
name
string
required
​
contact_email
string
required
​
parent_account_token
string
required

The token for the parent Account.

​
access_credential_tokens
string[]
required

The tokens for the Access Credentials assigned to the Managed Account.

​
billing_rule_tokens
string[]
required

The tokens for the Billing Rules assigned to the Managed Account.

​
email_domain
string | null

Email domain associated with this Managed Account for SSO.

​
msp_billing_profile_token
string | null

Token of the MSP billing profile used for this managed account (MSP invoicing accounts only)

​
billing_information_attributes
object
​
business_information_attributes
object