Start a conversation over Ada's email channel | Ada

Start a conversation with a customer over Ada’s email channel, providing context for their inquiry. Your AI agent can only start conversations using the default Ada provided email, or email addresses you’ve set up in your bring your own domain settings.

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.

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_idstringOptional

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())

Start a conversation over Ada’s email channel

Headers

Request

Response

Errors

1	{
2	"conversation_id": "5df263b7db5a7e6ea03fae9b"
3	}