POST
/
api
/
v2
/
createAccount
Create a new account
curl --request POST \
  --url https://api.vida.dev/api/v2/createAccount \
  --header 'Content-Type: application/json' \
  --data '{
  "accountName": "Acme Solar Bay Area Support Agent",
  "integrations": [
    {
      "appId": "some-app-id",
      "appVersion": "v1",
      "appData": {
        "apiToken": "APIToken"
      }
    },
    {
      "appId": "another-example-app",
      "appVersion": "v2",
      "appData": {
        "accountSid": "sidxxxxxxx",
        "accountToken": "tokenxxxxxxx",
        "apiUrl": "https://someurl.example"
      }
    }
  ]
}'
This response does not have an example.

Authorizations

token
string
query
required

Vida API Token

Query Parameters

targetOrganizationId
string
required

Organization Id to create account in

Body

application/json
accountName
string

Account Name

Example:

"Acme Solar Bay Area Support Agent"

integrations
object[]

Optional list of third-party app integrations to set up at org creation

Example:
[
{
"appId": "some-app-id",
"appVersion": "v1",
"appData": { "apiToken": "APIToken" }
},
{
"appId": "another-example-app",
"appVersion": "v2",
"appData": {
"accountSid": "sidxxxxxxx",
"accountToken": "tokenxxxxxxx",
"apiUrl": "https://someurl.example"
}
}
]

Response

OK