Create an inbound webhook

What you will accomplish

You will create an endpoint that accepts pushed records and securely capture its one-time credential.

Who can do this

Owners and Admins can manage inbound webhooks.

Before you start

Know the target track, rooftop, authentication method, JSON record shape, optional records path, and event-date field. Coordinate credential handling with the sending-system owner.

Create the webhook

1. Open Account menu → Config → Connect your data.
2. Select Webhooks.
3. Enter Connection name.
4. Select Target track and Rooftop.
5. Select Authentication.
6. Enter Records path when the pushed payload nests records.
7. Select the optional Event date field when applicable.
8. Select Create webhook.
9. Select Copy URL.
10. Select Copy for the access token or signing secret.
11. Store the credential in the sender's approved secret store.
12. Select Done.

The credential is intentionally revealed once. Do not log it in screenshots or support messages.

Maintain the webhook

1. Expand a connection to review its target.
2. Copy the endpoint URL when needed.
3. Select Rotate secret if a credential may be exposed.
4. Update the sender before retiring the previous setup.
5. Read Delivery history after a test event.

Expected result: an authenticated test delivery appears in Delivery history and valid mapped records are attributed to the configured track and rooftop.

Troubleshooting and recovery

• Unauthorized delivery: verify the sender's authentication implementation.
• Accepted request but no records: check records path, payload shape, mapping, and rooftop.
• A secret was exposed: rotate it immediately and update the sender.

Related articles

• Configure a JSON API connection
• Connect Birdseye with Zapier
• Troubleshoot data connections and imports