Skip to main content
POST
/
email
/
campaigns
/
{campaignId}
/
recipients
Add recipients
curl --request POST \
  --url https://www.dench.com/api/v1/email/campaigns/{campaignId}/recipients \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipients": [
    {
      "email": "ada@lovelace.dev",
      "displayName": "Ada Lovelace",
      "personalization": {
        "firstName": "Ada",
        "company": "Lovelace Labs"
      }
    }
  ]
}
'
{
  "added": 47,
  "duplicates": 2,
  "suppressed": 1,
  "invalid": 0,
  "totalRecipients": 120
}

Authorizations

Authorization
string
header
required

Workspace-scoped Dench API key from workspace settings. This is the same key used by DENCH_API_KEY in sandboxes.

Path Parameters

campaignId
string
required

Body

application/json
recipients
object[]
required

Up to 500 recipients per call.

Maximum array length: 500

Response

Successful response

added
number
required
duplicates
number
required
suppressed
number
required
invalid
number
required
totalRecipients
number
required