Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Amplitude Webhooks and Cohort Sync

The Webhooks Streaming destination forwards Amplitude event and user payloads to a customer-configured HTTPS endpoint, and the Cohort Sync family of destinations pushes cohort membership changes to downstream tools such as Iterable, Braze, MoEngage, Customer.io, Intercom, HubSpot, Google Ads, Bing Ads, Google Pub/Sub, Amazon Kinesis, and Amazon S3. Sync types include on-demand, automated (hourly or daily), and real-time (per-minute) modes. This AsyncAPI document models the subscriber-side HTTP contract for Webhooks Streaming and the generic cohort membership change shape; vendor-specific cohort sync destinations conform to each downstream tool's own API contract.

Amplitude Webhooks and Cohort Sync is one of 33 APIs that Amplitude publishes on the APIs.io network, described by an AsyncAPI event-driven specification.

Tagged areas include Cohort Sync, Destinations, Events, Streaming, and Webhooks. The published artifact set on APIs.io includes API documentation and an AsyncAPI specification.

This event API exposes 2 operations across 2 channels, and defines 6 schemas. It is described by AsyncAPI 2.6.0, at version 1.0.0.

The API connects through a single server, {webhookUrl} (https).

2 operations 2 channels 6 schemas

Metadata

The identity and technical contract details declared by the specification.

Specification
AsyncAPI 2.6.0
API Version
1.0.0
Server
{webhookUrl} (https)
Resource Areas
1

Channels & Operations 2

Across 2 channels, the API surfaces 2 operations. Each is listed below with its action, channel, parameters, and response codes.

Channels 2
PUB
/webhooks/streaming
Receive an Amplitude Webhooks Streaming payload.
receiveAmplitudeWebhook body
PUB
/cohort-sync/google-pubsub
Receive a cohort membership change message.
receiveCohortMembershipChange body

Messages & Schemas 6

The contract defines 6 schemas that model the data carried by its messages. The most detailed are AmplitudeEvent (40 properties), AmplitudeUser (19 properties), CohortMembershipChangePayload (9 properties). Each schema is shown below with its type and property counts.

WebhookEvent
message
Default Amplitude event payload forwarded by the Webhooks Streaming destination.
WebhookUser
message
Default Amplitude user payload forwarded by the Webhooks Streaming destination.
CohortMembershipChange
message
A user entered or exited a synced cohort.
AmplitudeEvent
object
Amplitude raw event format, as documented in the Export API reference. All fields are optional unless required by the event ingestion contract.
40 properties
AmplitudeUser
object
Amplitude user payload, as documented in the Identify API reference. Either userid or deviceid must identify the user; the remaining fields enrich the user rec…
19 properties
CohortMembershipChangePayload
object
Per-user cohort membership delta. Field set mirrors the columns Amplitude exposes in the cohort sync CSV log (Amplitude ID, operation, mapped properties, skip…
9 properties 3 required

Specification

The full machine-readable AsyncAPI contract behind this narrative.

Source

amplitude-webhooks-cohort-sync-asyncapi.yml Raw ↑

Other APIs Amplitude publishes across the network.

Amplitude Batch Event Upload API
Amplitude Identify API
Amplitude Group Identify API
Amplitude Export API
Amplitude Attribution API
Amplitude Releases API
Amplitude Session Replay API
Amplitude User Mapping API
Amplitude User Privacy API
Amplitude Annotations API
Amplitude Cohorts API
Amplitude Data Access API