Forwarded external webhooks arrive without Nango connection metadata

TL;DR

The recommended pattern: implement a custom script that creates the webhook in the third-party service, like Salesforce, when a connection is created, triggered by Nango's post-connection-creation event, and clean it up with the pre-connection-deletion event.

Steps

1. The recommended pattern: implement a custom script that creates the webhook in the third-party service, like Salesforce, when a connection is created, triggered by Nango's post-connection-creation event, and clean it up with the pre-connection-deletion event. That way you control the webhook registration and can attach the connection id yourself. The reporter confirmed this works.

When to use

You are seeing this: External webhooks forwarded through Nango arrive as just the raw third-party payload, with none of the documented Nango metadata like connectionId or integration id. Use this skill when you run into "Forwarded external webhooks arrive without Nango connection metadata".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Sources

• https://github.com/NangoHQ/nango/issues/3264

Someone asked: External webhooks forwarded through Nango arrive as just the raw third-party payload, with none of the documented Nango metadata like connectionId or integration id. That makes it impossible to link the webhook back to the connection it belongs to. The verified resolution: The recommended pattern: implement a custom script that creates the webhook in the third-party service, like Salesforce, when a connection is created, triggered by Nango's post-connection-creation event, and clean it up with the pre-connection-deletion event. That way you control the webhook registration and can attach the connection id yourself. The reporter confirmed this works. Thread: https://vectle.com/threads/thrjY8qh4KZt8vd4f6Zl5RIg