{
"type": "contact.subscribed",
"webhook_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
"timestamp": "2026-10-21T10:15:00Z",
"data": {
"account_id": "4cdd7bdd-294e-4762-892f-83d40abf5a87",
"origin": "api",
"contact": {
"object": "contact",
"id": "e43e4167-f186-4a7f-9b6e-ac9fdc6426e1",
"created_at": "2026-09-21T10:15:00Z",
"updated_at": "2026-10-21T10:15:00Z",
"email": "someone@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"status": "enabled",
"status_reason": "",
"unsubscribed": false,
"unsubscribed_at": null,
"attributes": {
"plan": "pro"
},
"validation_status": "valid",
"last_validated_at": "2026-10-20T10:15:00Z"
},
"list": {
"id": "8b5a3112-8fa1-4bde-9c20-8af76484daf4",
"name": "Newsletter"
},
"list_contact": {
"object": "list_contact",
"list_id": "8b5a3112-8fa1-4bde-9c20-8af76484daf4",
"contact_id": "e43e4167-f186-4a7f-9b6e-ac9fdc6426e1",
"email": "someone@example.com",
"subscription_status": "confirmed",
"subscribed_at": "2026-09-21T10:15:00Z",
"unsubscribed_at": null,
"created_at": "2026-09-21T10:15:00Z",
"updated_at": "2026-10-21T10:15:00Z"
},
"previous_subscription_status": "unsubscribed"
}
}Contact Events
contact.subscribed Webhook Event
The contact.subscribed webhook fires when an AhaSend list membership becomes confirmed, or a contact’s unsubscribe from all lists is cleared. Payload.
WEBHOOK
contact.subscribed
{
"type": "contact.subscribed",
"webhook_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
"timestamp": "2026-10-21T10:15:00Z",
"data": {
"account_id": "4cdd7bdd-294e-4762-892f-83d40abf5a87",
"origin": "api",
"contact": {
"object": "contact",
"id": "e43e4167-f186-4a7f-9b6e-ac9fdc6426e1",
"created_at": "2026-09-21T10:15:00Z",
"updated_at": "2026-10-21T10:15:00Z",
"email": "someone@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"status": "enabled",
"status_reason": "",
"unsubscribed": false,
"unsubscribed_at": null,
"attributes": {
"plan": "pro"
},
"validation_status": "valid",
"last_validated_at": "2026-10-20T10:15:00Z"
},
"list": {
"id": "8b5a3112-8fa1-4bde-9c20-8af76484daf4",
"name": "Newsletter"
},
"list_contact": {
"object": "list_contact",
"list_id": "8b5a3112-8fa1-4bde-9c20-8af76484daf4",
"contact_id": "e43e4167-f186-4a7f-9b6e-ac9fdc6426e1",
"email": "someone@example.com",
"subscription_status": "confirmed",
"subscribed_at": "2026-09-21T10:15:00Z",
"unsubscribed_at": null,
"created_at": "2026-09-21T10:15:00Z",
"updated_at": "2026-10-21T10:15:00Z"
},
"previous_subscription_status": "unsubscribed"
}
}AhaSend sends this event when a membership’s subscription status becomes
confirmed, or when the contact’s unsubscribe from all lists is cleared (unsubscribed changes to false).
For a membership, data.previous_subscription_status is the status before the change. For the unsubscribe from all lists, data.list and data.list_contact are null.
No event: A new membership, which sends contact.added_to_list.
Setting: on_contact_subscribed (Contact Subscribed in the dashboard).
Requirements:
- Your account has the marketing features. Contact events cannot be turned on without them.
- A webhook with this event on needs an API key with
contacts:readandlists:readwhen you create or update it through the API. See contact events.
confirmed, or when its unsubscribe from all lists is cleared.
Related Guides
- API authentication, Permission scopes, Webhook setup.
- Event reference, Webhook CLI, Local webhook testing.
- Signature verification, Retry policy, API errors.
- API rate limits, Contacts API, Lists API.
Body
application/json
The event type
Available options:
contact.subscribed The webhook ID (the same ID as returned by the Create Webhook API)
When the change happened (ISO 8601 format)
Show child attributes
Show child attributes
Response
Webhook received successfully