Create a subaccount

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

subaccount_namestringRequired

The name for the new subaccount. This should be a unique identifier that distinguishes it from other subaccounts within the main account.

user_emailstringOptional

This is the email address of the user you wish to invite to the subaccount. When this optional parameter is filled in, a "sign in" link will be generated and sent back in the response. The user can use this link to sign in and set up their account.

twilio_account_sidstringOptional

This is the Twilio SID of the subaccount.

twilio_auth_tokenstringOptional

This is the Twilio Token of the subaccount.

Response

200

statusstring

Whether the request was successful.

responseobject

Errors

400

Bad Request Error

1	import requests
2
3	url = "https://api.synthflow.ai/v2/subaccounts"
4
5	payload = {
6	"subaccount_name": "string",
7	"user_email": "subaccount@example.com"
8	}
9	headers = {
10	"Authorization": "Bearer <token>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())

1	{
2	"status": "ok",
3	"response": {
4	"subaccount_id": "1726005822670x239735712159542050",
5	"api_key": "1739402187001x558120349876512300",
6	"user_email": "onboarding+acme@synthflow.ai",
7	"sign_in_link": "https://app.synthflow.ai/invite/1739402199888x447700112233445500",
8	"twilio_connected_successfully": true
9	}
10	}