Skip to main content
POST
/
conversations
/
{id}
/
recipients
Add a recipient to a conversation
curl --request POST \
  --url https://api.getfernand.com/conversations/{id}/recipients \
  --header 'X-API-Key: <api-key>'
{
  "id": 12345,
  "contact_id": 789,
  "kind": "cc",
  "conversation_id": 456
}
Adds a new recipient to an existing conversation. The recipient can be specified by email address with optional name (in Name <email@example.com> format). A new contact is created if the email doesn’t exist. If this is the first recipient being added to the conversation, they become the ‘from’ contact; otherwise, they’re added as ‘cc’.

Authorizations

​
X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Path Parameters

​
id
integer<int64>
required

ID of the conversation

Query Parameters

​
email
string<email>
required

Email address of the recipient, optionally with name

Response

Recipient added successfully

​
id
integer<int64>
required

Unique identifier for the recipient

Example:

12345

​
contact_id
integer<int64>
required

ID of the contact that is a recipient of this conversation

Example:

789

​
kind
enum<string>
required

Type of recipient (to, cc, bcc, from, or reply-to)

Available options:
to,
cc,
bcc,
from,
reply-to
Example:

"cc"

​
conversation_id
integer<int64>
required

ID of the conversation this recipient belongs to

Example:

456