Start a conversation over Ada's email channel

Start a conversation with an end user over Ada's native Email channel, providing context for their inquiry. **This endpoint is exclusive to the native Email channel and cannot be used for custom channels.** Your AI Agent can start conversations only with the default Ada-provided email address, or with email addresses you’ve configured through Bring Your Own Domain (BYOD) settings.

Start a conversation with an end user over Ada’s native Email channel, providing context for their inquiry. This endpoint is exclusive to the native Email channel and cannot be used for custom channels. Your AI Agent can start conversations only with the default Ada-provided email address, or with email addresses you’ve configured through Bring Your Own Domain (BYOD) settings.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired

The customer's full name

subjectstringRequired

The subject of the customer’s inquiry; used as the subject for the AI Agent’s reply

reply_tostringRequired

The customer's email address

textstringOptional

The customer's inquiry, limited to 10 KB

reply_asstringOptional

The company email address you want to use to reply to the customer. Defaults to the Ada provided email address.

cclist of stringsOptional

The email addresses in the email's CC field

metadataobjectOptional

Any metadata associated with the conversation, up to 4 KB. All metadata passed through this field will appear as metavariables in your dashboard.

Response

Conversation Created

conversation_idstringRead-only

The Ada-generated conversation id

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

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

This endpoint expects an object.

The customer's full name

The subject of the customer’s inquiry; used as the subject for the AI Agent’s reply

The customer's email address

The customer's inquiry, limited to 10 KB

The company email address you want to use to reply to the customer. Defaults to the Ada provided email address.

The email addresses in the email's CC field

Any metadata associated with the conversation, up to 4 KB. All metadata passed through this field will appear as metavariables in your dashboard.

Conversation Created

The Ada-generated conversation id

1	import requests
2
3	url = "https://example.ada.support/api/v2/conversations/email/"
4
5	payload = {
6	"name": "Firstname Lastname",
7	"subject": "Email subject",
8	"reply_to": "user@mail.com"
9	}
10	headers = {
11	"Authorization": "Bearer <token>",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.post(url, json=payload, headers=headers)
16
17	print(response.json())

1	import requests
2
3	url = "https://example.ada.support/api/v2/conversations/email/"
4
5	payload = {
6	"name": "Firstname Lastname",
7	"subject": "Email subject",
8	"reply_to": "user@mail.com"
9	}
10	headers = {
11	"Authorization": "Bearer <token>",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.post(url, json=payload, headers=headers)
16
17	print(response.json())