Push Webhook

LAST EDIT Oct 07 2024

Using the Push webhook, you can receive payloads of all events from your application. When configured, every event in the Chat application will propagate to your webhook endpoint. The complete list of supported events can be found on Events page.

Use-cases

Copied!

Push webhooks are useful when you want your server application to be in sync with the chat. Here are some examples:

  • Implementing a complex notification system (e.g. involving SMS and/or e-mail)

  • Migration from a different chat provider to Stream Chat without disruption

  • User activity monitoring

Request format

Copied!

Your endpoint will receive a POST request with a JSON encoded body containing the event and all corresponding fields:

See more payload examples on Events page.

Performance and Error Handling

Copied!

In case of the request failure Stream Chat attempts to retry a request. The amount of maximum attempts depends on the kind of the error it receives:

  • Response code is 408, 429 or >=500: 3 attempts

  • Network error: 2 attempts

  • Request timeout: 3 attempts

The timeout of one request is 6 seconds, and the request with all retries cannot exceed the duration of 15 seconds.