With Linked Helper cloud-based storatge version, it is possible to add profiles to a campaign via incoming webhook.
Creating webhook
Note: incoming webhooks available only for Linked Helper cloud-based storage version users.
- Open a campaign and navigate to Workflow tab
- Click Webhook icon next to the Add button
- Give it a name and click Add webhook button
- Once webhook is created, you can:
- enable Stand by mode which allows you to keep campaign ready to resume when new profiles received, otherwise you will need to start it manually when profiles have been added;
- copy webhook URL and add to your other tool:
- Add another webhook to receive profiles from different sources:
Sending data to webhook
Payload schema and examples
Webhook can receive POST requests with payload data in the request body:
- required: LinkedIn or Sales Navigator URLs
- optional: custom fields
It's possible to send multiple URLs in one request, each one having several custom fields (or none at all).
Payload Schema:
{
"type": "object",
"required": ["payload"],
"properties": {
"payload": {
"type": "object",
"required": ["people"],
"properties": {
"people": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["externalId"],
"properties": {
"externalId": {
"type": "string",
"minLength": 1,
"format": "uri",
"description": "LI/SN profile URL. Backend extracts person external id from the link."
},
"customFields": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["key", "value"],
"properties": {
"key": {
"type": "string",
"minLength": 4,
"pattern": "^cs_.+"
},
"value": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Optional per-person custom fields."
}
},
"additionalProperties": false
},
"description": "List of people to add to campaign."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
Payload Example with custom variables:
{
"payload": {
"people": [
{
"externalId": "https://www.linkedin.com/in/jane-doe-123456789/",
"customFields": [
{
"key": "cs_source",
"value": "webhook"
}
]
},
{
"externalId": "https://www.linkedin.com/sales/lead/ACwAAAZXyZABcD1234567890abcdef,NAME_SEARCH,abcd1234",
"customFields": [
{
"key": "cs_source",
"value": "manual-import"
},
{
"key": "cs_segment",
"value": "enterprise"
}
]
}
]
}
}
Payload Example without custom variables:
{
"payload": {
"people": [
{
"externalId": "https://www.linkedin.com/in/jane-doe-123456789/",
"customFields": []
},
{
"externalId": "https://www.linkedin.com/sales/lead/ACwAAAZXyZABcD1234567890abcdef,NAME_SEARCH,abcd1234",
"customFields": []
}
]
}
}
Sending data from Make.com
In the example below, we will be sending data from a Linked Helper local-based storage account into Make.com incoming webhook, and then forward needed information to a Linked Helper cloud-based storage account.
Before adding HTTP request, make sure you already sent some data to the scenario. In the case below, we sent a data from Linked Helper to make.com webhook, so that we can set up mapping later.
- Click plus button to add a step to your scenario. Find HTTP into search field and choose Make a request option.
- Set general settings as per the list below:
- Authentication type: no authentication
- URL: your Linked Helper webhook URL
- Method: POST
- Body content type: application/json
- Body input method: Data structure
- Leave the rest fields as they are unless you need custom settings.
-
In the Body structure field, click Add button to add a new structure for Linked Helper webhook, and give it a name.
- Copy the payload example from the section above.
- Click Generate button under Specification section and paste copied schema to he Sample data field to generate data structure.
- Once data structure is generated, set the following fields as required:
- payload
- people
- extrernalId
- key
- value
- When data structure is saved, set up the body content by mapping the fields by adding items and using data you already sent to the webhook. Click the Add item button below People array section.
- Map the externalId field with a field that contains URL. In our case, we mapped profile_url field.
Note: that URL field is already available as it has been received from previous scenario step. We already sent data from Linked Helper to Make webhook, but setup of the previous steps is beyond the scope of this article, so it is not covered here. - The same way you can map one or several custom fields that will be sent along with that person. However, custom variables are not mandatory as Linked Helper can collect other profile information such as full name later from LinkedIn:
- Once data fields are mapped, save changes and test your webhook. Please, note that you need to refresh Linked Helper UI by switching between lists (e.g. switch to Processed and back to Profiles to process) to see recently added profiles:
Deleting webhook
- Open a campaign and navigate to Workflow tab
- Click Webhook icon next to the Add button
- Click Bin button in the row of the webhook you'd like to delete and confirm the action:
Related features: