Exit IP changed | Swarmhit Developers

Gateway event, both channels (account_type: WHATSAPP on numbers). gateway.proxy_drift: the exit left its country or could not be confirmed (the account is held); gateway.proxy_changed: a new IP in the same country and ISP; gateway.proxy_recovered: moved to a new IP after a hold.

Header Parameters

X-LG-Signature*string

base64url(HMAC-SHA256(raw body, your webhook's signing secret)), the secret being the whsec_… shown in the console. Verify it over the raw bytes before parsing, and refuse the event when it does not match.

X-LG-Event-Id*string

The event id, also event_id in the body: the same on every retry of the event. Deduplicate on it.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

event*string

gateway.proxy_drift: the exit IP left the account's country, changed ISP, is another account's or could not be confirmed; the account is held (STOPPED, proxy_drift). gateway.proxy_changed: a new IP, same country and ISP, nothing to do. gateway.proxy_recovered: a new IP after a hold.

Value in

"gateway.proxy_drift"
"gateway.proxy_changed"
"gateway.proxy_recovered"

account_id*string

The account: lg_… (LinkedIn) or wa_… (WhatsApp).

account_type?string

WHATSAPP on a WhatsApp number's events; absent on a LinkedIn account's.

ip?string

The exit IP the account now uses (or, for a drift, the one it found).

country?|

That IP's country (ISO code); null when it could not be told.

isp?|

That IP's internet provider; null when unknown.

expected_country?|

gateway.proxy_drift only: the country the account is meant to be in; null when none is set.

reason?string

gateway.proxy_drift only: country (another country), isp (another internet provider), shared (the IP is another account's) or unverified (the country could not be confirmed).

event_id*string

The event's id, also in the X-LG-Event-Id header: the same on every retry of the event, so deduplicate on it. A random UUID, or ev_… for an event about one thing (a message, a connection) noticed twice.

emitted_at*string

When Swarmhit wrote the event (UTC, ISO 8601), not when it was delivered. A retry keeps it: for statuses, keep the one with the newest emitted_at.

Formatdate-time

livemode?boolean

true for an event of a live account, false for a sandbox account's (sent to your sandbox webhook).

Response Body

Example Requests

POST/Proxy

Header Parameters

Request Body

Response Body

200

Request Bodyapplication/json

Header Parameters