A Webhook connector sends each company in a segment you choose to a URL of yours, as JSON, as soon as the visit is processed. Use it to send companies to your own system or to any tool that accepts webhooks.
New to webhooks? See What are Webhooks?
You need a URL that accepts an HTTP POST with a JSON body.
Webhooks are available on sales-led plans. If Webhook has an Upgrade badge in the Create Connector window, your plan doesn't include it. Contact us via the chat to add it.
Step 1: Create the connector
In the sidebar, click Connectors, then Create Connector.
In Send Data to Integration, choose Webhook.
Step 2: Set up the connector
Under General:
Give the connector a Connector name.
Paste the URL the companies should be sent to.
Keep Include security token ticked if your endpoint should check that requests come from Albacross. Each request then carries the Token shown below it in the
Authorizationheader. Click Copy to copy it to your system.
Under Conditions:
Pick the Segment whose companies you want to send. To create or change a segment, go to Website Visitors → Segments.
Choose Send only new companies or Send new and returning companies. A returning company is sent again with its latest activity.
Under Output:
Keep Custom Format on Default to get the JSON shown below. The other formats (Microsoft Teams, Hangout Chat and Mattermost) send a ready-made chat message instead.
Under Type of data, choose Company, Contacts (email) or Contacts (email + phone). With contacts, set the Contact settings: how many contacts per company, keywords or a buyer persona, countries and conditions. Exported contacts use your workspace's contact credits.
Click Show request example to see the request, then click Save changes.
What your endpoint receives
Each company is one POST request with a JSON body like this one (with the Default format). contacts is empty unless you chose contacts. type is new for a first send and update for a returning company. Fields we don't have for a company are null.
{
"address": {
"address": "Main Street 1",
"city": "Stockholm",
"state": "Stockholm County",
"zip_code": "111 35"
},
"commercial_register_code": null,
"contacts": [
{
"department": "Sales",
"email": "sam.carter@northwind.example",
"first_name": "Sam",
"id": "c-1234",
"last_name": "Carter",
"linkedin": "https://www.linkedin.com/in/sam-carter-example/",
"phone_number": "+46 8 123 45 67",
"position": "Head of Sales",
"seniority": "director",
"type": "personal"
}
],
"contacts_url": "https://app.albacross.com/profile/ALBA-SE-northwind~example/contacts",
"country": "SE",
"description": "Northwind Analytics builds reporting software for retailers.",
"duration": 3000,
"employees": {
"from": 11,
"to": 50,
"year": 2025
},
"financial_report": {
"currency": "EUR",
"revenue_from": 10000001,
"revenue_to": 50000000,
"year": 2025
},
"founded_at": 2013,
"gclids": [],
"id": "ALBA-SE-northwind~example",
"industry_category": "Computer Software",
"industry_code": "4",
"last_visit": 1763458800000,
"nace_code": "6201",
"nace_text": "Computer programming activities",
"name": "Northwind Analytics",
"organisation_number": "SE000001",
"pages": [
{
"page_views": 6,
"page_views_pct": 60,
"url": "/pricing",
"value_percentage": 60
},
{
"page_views": 4,
"page_views_pct": 40,
"url": "/",
"value_percentage": 40
}
],
"pages_high_intent": [
{
"page_views": 6,
"page_views_pct": 60,
"url": "/pricing"
}
],
"pages_visited": 10,
"phone_number": {
"country": "SE",
"country_code": 46,
"number": "81234567"
},
"profile_url": "https://app.albacross.com/profile/ALBA-SE-northwind~example",
"segment_name": "High buying intent",
"socials": {
"crunchbase": null,
"facebook": null,
"linkedin": "https://www.linkedin.com/company/northwind-example",
"linkedin_url": "https://www.linkedin.com/company/northwind-example",
"twitter": null
},
"source": "Albacross",
"tags": "Hot lead, Target account",
"timestamp": 1763458860000,
"total_funding": null,
"type": "new",
"unique_pages_visited_30_days": 3,
"unique_pages_visited_7_days": 2,
"unique_pages_visited_90_days": 3,
"utms": {
"campaigns": ["autumn-launch"],
"contents": [],
"mediums": ["cpc"],
"sources": ["google"],
"terms": []
},
"visits": 3,
"website": "northwind.example"
}
Your endpoint needs to answer with a 2xx status within 5 seconds, and should be ready to get the same company more than once. See Webhook delivery: timeouts and retries.
Manage the connector
Your connector is listed under Connectors. Click the Webhook filter to see only these. Click a connector to edit it, or open the ⋮ menu on its row to Pause or Resume it, Duplicate it, Send example (a sample company sent to your URL, to test your endpoint) or Remove it.
To see what the connector sent and whether it worked, open its Activity Log. See The Activity Log: what your connectors sent.






