Skip to main content

Turn Events API

warning

This API is going to be deprecated at some point in the future. If you were planning to start using it, please instead refer to Channels API

The events API allows you to send external events to Turn, they will be displayed in the chat history.

note

Currently the only supported event type is external message but this will be expanded in the future to allow more types.

External Message Example​

To send a external message to Turn, do the following request:

$ curl -X POST "https://whatsapp.turn.io/v1/events" \
  -H "Authorization: Bearer token" \
  -H "Content-Type: application/json" \
  -H "accept: application/vnd.v1+json"
  -d '
    {
        "event_type": "external_message",
        "urn": "+16315551003",
        "timestamp": 1555493466000,
        "event_id": "1111117",
        "details": {
            "content": "Hi how are you?",
            "direction": "inbound",
            "from_addr": "+16315551003"
        }
    }'