Documentation

Event ingestion API reference

Authentication

Use your Ingestion API key in the Authorization header. You can send either ing_... directly or Bearer ing_....

Important: use an Ingestion API key for this endpoint. For platform integrations, refer to the Platform API documentation.

Send Contact Events
POST /events with entity_type=user
Send Company Events
POST /events with entity_type=company
Send Contact Events
Use POST /events with entity_type=user.
{
    "entity_type": "user",
    "entity_id": "contact_12345",
    "company_id": "company_98765",
    "event_type": "contact.logged_in",
    "properties": {
        "login_method": "email"
    }
}
Send Company Events
Use POST /events with entity_type=company.
{
    "entity_type": "company",
    "entity_id": "company_98765",
    "event_type": "company.subscription_upgraded",
    "properties": {
        "from_plan": "starter",
        "to_plan": "pro"
    }
}
Loading ...