Link Swapping
Link Swap Event
Our link swap subscription is different from all other webhooks in that we make a POST request to your subscription url with the link_swap
event type and then we wait for your response. This way, you don't have to make a new and separate request back to us with the new links.
Check out our Webhooks Endpoints or Documentation to set this up.
Delivery Headers
HTTP POST payloads that are delivered to your callback_url will contain several special headers:
Header | Description |
---|---|
x-salesloft-event | Name of the event type that triggered the delivery. Must be one of: link_swap |
x-salesloft-signature | The HMAC hex digest of the response body. The HMAC hex digest is generated using the sha1 hash function and the callback_token as the HMAC key . |
You will get a payload that looks like this:
Link Swap Response Example
{
"user": {
"id": 1,
"email": "myteammember@salesloft.com"
},
"team": {
"id": 123456
},
"mailing": {
"id": 30
},
"email": {
"id": 30
},
"person": {
"id": 1,
"email": "myteammember3@gmail.com"
},
"links": [
"http://OLD-LINK.COM", "http://ANOTHER-OLD-LINK.COM"
]
}
Payload Example
For Link_Swap events, you will return a json hash where the old link is the key and the new link is the value. We look at the response and expect to see something like this:
{
"links": {
"http://OLD-LINK.COM": "http://NEW-LINK.com",
"http://ANOTHER-OLD-LINK.COM": "http://ANOTHER-NEW-LINK.com"
}
}