send_event
Record a custom event for a contact using email or contactId. Unknown email creates new subscribed contact and triggers matching automations.
Instructions
Record a custom event about a contact ("order_placed", "trial_started", …) — identify them by email OR contactId (exactly one). An unknown email becomes a new subscribed contact. The event is stored durably and fire-and-forget starts any ACTIVE automations with a matching {type:"event", eventName} trigger. Returns 202 {accepted:true}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "send_event"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Event name automations match on, e.g. order_placed. | |
| No | Contact email (XOR contactId). | ||
| sender | No | Product/sender externalId sent as X-Drin-Sender. Required only for account-wide API keys; overrides the server's default sender. | |
| payload | No | Free-form event payload (≤8KB as JSON). | |
| contactId | No | Contact id (XOR email). |