Create account

Create a new customer account with optional contacts and initial configuration. Browse request parameters, authentication requirements, response payloads,…

Create a new customer account with optional contacts and initial configuration.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

title*string

Account/company name

Length1 <= length

description?string

Account description or notes

review_status?string

Initial review status

Default"to_review"

Value in

"to_review"
"in_review"
"approved"
"cancelled"

auto_approval?boolean

Whether to automatically approve access requests from this account's domain

Defaultfalse

contacts?array<>

Initial contact persons to create

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/accounts" \  -H "Content-Type: application/json" \  -d '{    "title": "Acme Corporation",    "description": "Enterprise customer account",    "review_status": "to_review"  }'

{  "success": true,  "data": {    "account": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "title": "string",      "description": "string",      "review_status": "to_review",      "sfdc_account_id": "string",      "domain": "string",      "logo": "string",      "access_expiry_datetime": "2019-08-24T14:15:22Z",      "nda": true,      "type": "standard",      "internal_notes": "string",      "auto_approval": false,      "date_created": "2019-08-24T14:15:22Z",      "contacts": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "email": "user@example.com",          "first_name": "string",          "last_name": "string",          "title": "string"        }      ]    }  }}

How is this guide?

Authorization

Request Body

Response Body

201application/json

400application/json

401

409

500

`application/json`

`application/json`