ZenABM API

v1.0

The ZenABM API gives you programmatic access to your ABM data — companies, campaigns, deals, job titles, ABM stages, and more. All endpoints return JSON and require Bearer token authentication.

Basehttps://app.zenabm.com/api/v1
AuthBearer token
FormatJSON
Quick start
curl "https://app.zenabm.com/api/v1/companies?pageSize=5" \
  -H "Authorization: Bearer sk_live_xxx"
Open in Postman

Authentication

Authenticate by including your API token in the Authorization header of every request. Generate tokens from your API Keys page.

Security: Keep your token secret. Never expose it in client-side code, Git repos, or logs.

Header
Authorization: Bearer sk_live_your_api_token
Error (401)
{
  "error": {
    "status": 401,
    "code": "UNAUTHORIZED",
    "message": "Invalid API token"
  }
}

Companies

Companies represent organizations that have engaged with your LinkedIn ads. Each company includes engagement metrics, ABM stage data, and CRM match status.

||

List companies with insights

||
GET/companies

Returns a paginated list of companies with engagement metrics. Filter by campaigns, ABM stages, engagement scores, or CRM match status.

Request
curl "https://app.zenabm.com/api/v1/companies?period=last30Days&campaigns=cm1abc,cm2def&engagementScores=3,4,5" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "1337",
      "name": "Pied Piper",
      "city": "Palo Alto",
      "country": "US",
      "website": "https://www.piedpiper.com/",
      "linkedInOrgId": "4827017",
      "hubspotCompanyId": "37411334702",
      "lifetimeEngagementScore": 3,
      "abmStageId": "1337_interested",
      "lifetimeAbmStageId": "1337_interested",
      "logoUrl": "https://piedpiper.com/assets/images/logo.png",
      "abmStage": {
        "id": "1337_interested",
        "name": "Interested",
        "color": "#10B981",
        "displayOrder": 3,
        "isManuallyOverridden": false,
        "overrideTimestamp": null
      },
      "lifetimeAbmStage": {
        "id": "1337_interested",
        "name": "Interested",
        "color": "#10B981",
        "displayOrder": 3
      },
      "intents": [
        {
          "id": "cm9iaw4a50001jr04wqc1k4dt",
          "name": "Competitor"
        }
      ],
      "impressions": 109198,
      "clicks": 468,
      "engagements": 2769,
      "costInUsd": 2797.37,
      "currentEngagementScore": 2,
      "abmCampaigns": [
        {
          "id": "1337",
          "name": "Techcrunch 2025"
        }
      ],
      "exclusion": null
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 1,
    "totalCount": 35960,
    "totalPages": 35960
  },
  "meta": {
    "timestamp": "2026-03-09T18:08:06.901Z"
  }
}

Get company by ID

||
GET/companies/{id}

Retrieve a single company by its ID, including full profile and current metrics.

Request
curl "https://app.zenabm.com/api/v1/companies/{id}" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "id": "1337",
    "name": "Pied Piper",
    "country": "US",
    "city": "Palo Alto",
    "website": "https://www.piedpiper.com/",
    "logoUrl": "https://piedpiper.com/assets/images/logo.png",
    "linkedInOrgId": "4827017",
    "hubspotCompanyId": "37411334702",
    "abmStage": {
      "id": "1337_interested",
      "name": "Interested",
      "color": "#10B981",
      "displayOrder": 3
    },
    "lifetimeAbmStage": {
      "id": "1337_interested",
      "name": "Interested",
      "color": "#10B981",
      "displayOrder": 3
    },
    "lifetimeEngagementScore": 5,
    "exclusionCount": 0
  },
  "meta": {
    "timestamp": "2026-03-09T18:34:17.198Z"
  }
}

Get company metrics overview

||
GET/companies/{id}/overview

Returns aggregated and weekly metrics for a company over a given time period.

Request
curl "https://app.zenabm.com/api/v1/companies/{id}/overview?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "summary": {
      "impressions": 109198,
      "clicks": 468,
      "engagements": 2769,
      "costInUsd": 2797.37
    },
    "weeklyData": [
      {
        "weekStart": "2025-03-03",
        "weekEnd": "2025-03-09",
        "impressions": 142,
        "clicks": 3,
        "engagements": 2,
        "costInUsd": 45.72
      },
      {
        "weekStart": "2025-03-10",
        "weekEnd": "2025-03-16",
        "impressions": 3607,
        "clicks": 31,
        "engagements": 35,
        "costInUsd": 106.35
      }
    ]
  },
  "meta": {
    "timestamp": "2026-03-09T18:30:27.973Z"
  }
}

List campaigns for a company

||
GET/companies/{id}/campaigns

Returns campaigns that a specific company has been exposed to, with per-company metrics.

Request
curl "https://app.zenabm.com/api/v1/companies/{id}/campaigns?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "1337_campaign_id",
      "name": "Techcrunch 2025",
      "impressions": 5923,
      "clicks": 31,
      "engagements": 58,
      "costInUsd": 436.58,
      "intents": [
        {
          "id": "1337",
          "name": "Competitor"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 114,
    "totalPages": 6
  },
  "meta": {
    "timestamp": "2026-03-09T18:41:52.562Z"
  }
}

List campaign groups for a company

||
GET/companies/{id}/campaign-groups

Optional filters: sortBy, sortOrder, search

Request
curl "https://app.zenabm.com/api/v1/companies/{id}/campaign-groups?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "1337_campaign_group_id",
      "name": "Techcrunch 2025 CG",
      "impressions": 47759,
      "clicks": 273,
      "engagements": 2380,
      "costInUsd": 1580.19
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 35,
    "totalPages": 2
  },
  "meta": {
    "timestamp": "2026-03-09T18:44:34.534Z"
  }
}

List ABM campaigns for a company

||
GET/companies/{id}/abm-campaigns

Optional filters: sortBy, sortOrder

Request
curl "https://app.zenabm.com/api/v1/companies/{id}/abm-campaigns?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "1337_abm_campaign_id",
      "name": "Silicon Valley 2025",
      "status": "ACTIVE",
      "impressions": 111554,
      "clicks": 462,
      "engagements": 2763,
      "costInUsd": 2232.13
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 8,
    "totalPages": 1
  },
  "meta": {
    "timestamp": "2026-03-09T18:51:43.208Z"
  }
}

Get company timeline

||
GET/companies/{id}/timeline

Returns a chronological list of engagement events for a company within a date range.

Request
curl "https://app.zenabm.com/api/v1/companies/{id}/timeline" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "summary": {
      "impressions": 109617,
      "clicks": 468,
      "engagements": 2769,
      "costInUsd": 2797.37
    },
    "deals": [],
    "stageHistory": [
      {
        "stageId": "1337_identified",
        "stageName": "Identified",
        "stageColor": "#3B82F6",
        "enteredAt": "2025-03-01T00:00:00.000Z",
        "previousStageName": null
      },
      {
        "stageId": "1337_aware",
        "stageName": "Aware",
        "stageColor": "#A855F7",
        "enteredAt": "2025-04-15T00:00:00.000Z",
        "previousStageName": "Identified"
      }
    ]
  },
  "meta": {
    "timestamp": "2026-03-09T19:00:28.135Z"
  }
}

Get company activity log

||
GET/companies/{id}/activity-log

Optional: limit (max entries)

Request
curl "https://app.zenabm.com/api/v1/companies/{id}/activity-log" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "lifetime-stage-1337",
      "type": "lifetime_abm_stage_change",
      "date": "2025-09-01T11:00:00.000Z",
      "title": "Lifetime ABM Stage changed to Interested",
      "description": "Previously: Aware",
      "toStage": {
        "id": "1337_interested",
        "name": "Interested",
        "color": "#10B981"
      },
      "fromStage": {
        "id": "1337_aware",
        "name": "Aware",
        "color": "#A855F7"
      }
    },
    {
      "id": "lifetime-stage-1338",
      "type": "lifetime_abm_stage_change",
      "date": "2025-06-15T08:00:00.000Z",
      "title": "Lifetime ABM Stage changed to Aware",
      "description": "Previously: Identified",
      "toStage": {
        "id": "1337_aware",
        "name": "Aware",
        "color": "#A855F7"
      },
      "fromStage": {
        "id": "1337_identified",
        "name": "Identified",
        "color": "#3B82F6"
      }
    }
  ],
  "meta": {
    "timestamp": "2026-03-09T19:02:02.855Z"
  }
}

Get deals for a company

||
GET/companies/{id}/deals

Optional filters: sortBy, sortOrder

Request
curl "https://app.zenabm.com/api/v1/companies/{id}/deals" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "data": [
      {
        "id": "clxyz123abc",
        "dealName": "Acme Corp - Enterprise License",
        "hubspotId": "12345678",
        "hubspotPortalId": "98765432",
        "amount": 45000,
        "linkedinInfluenced": true,
        "abmInfluenced": true,
        "hubspotCreatedAt": "2025-03-15T10:30:00.000Z",
        "hubspotClosedAt": "2025-06-20T14:00:00.000Z",
        "company": {
          "id": "1337",
          "name": "Pied Piper",
          "logoUrl": "https://piedpiper.com/assets/images/logo.png",
          "website": "https://piedpiper.com",
          "linkedInOrgId": "12345",
          "hubspotCompanyId": "9876543",
          "country": "United States",
          "hubspotPortalId": "98765432"
        },
        "stage": {
          "id": "1337_closed_won",
          "name": "Closed Won"
        },
        "campaigns": [
          {
            "id": "1337",
            "name": "Q1 Enterprise ABM Campaign"
          }
        ],
        "impressionsBeforeDeal": 8450,
        "impressionsAfterDeal": 3200,
        "linkedinImpressionsBeforeDeal": 5200,
        "abmImpressionsBeforeDeal": 3250,
        "linkedinImpressionsAfterDeal": 1800,
        "abmImpressionsAfterDeal": 1400,
        "clicksBeforeDeal": 142,
        "clicksAfterDeal": 58,
        "linkedinClicksBeforeDeal": 89,
        "abmClicksBeforeDeal": 53,
        "linkedinClicksAfterDeal": 34,
        "abmClicksAfterDeal": 24,
        "engagementsBeforeDeal": 312,
        "engagementsAfterDeal": 95,
        "linkedinEngagementsBeforeDeal": 198,
        "abmEngagementsBeforeDeal": 114,
        "linkedinEngagementsAfterDeal": 60,
        "abmEngagementsAfterDeal": 35
      }
    ],
    "count": 3
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Get ABM stages for a company

||
GET/companies/{id}/abm-stages

Returns the ABM stage history for a company, showing progression through your funnel.

Request
curl "https://app.zenabm.com/api/v1/companies/{id}/abm-stages" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "context": "overall",
      "abmStage": {
        "id": "cls1abc123",
        "name": "Engaged",
        "color": "#4CAF50"
      },
      "previousStage": {
        "id": "cls2def456",
        "name": "Aware",
        "color": "#FFC107"
      },
      "campaign": null,
      "stageHistory": [
        {
          "stageId": "cls1abc123",
          "stageName": "Engaged",
          "color": "#4CAF50",
          "date": "2025-08-12T09:30:00.000Z"
        },
        {
          "stageId": "cls2def456",
          "stageName": "Aware",
          "color": "#FFC107",
          "date": "2025-04-20T14:15:00.000Z"
        }
      ],
      "latestChangeDate": "2025-08-12T09:30:00.000Z"
    },
    {
      "context": "lifetime",
      "abmStage": {
        "id": "cls1abc123",
        "name": "Engaged",
        "color": "#4CAF50"
      },
      "previousStage": null,
      "campaign": null,
      "stageHistory": [],
      "latestChangeDate": null
    },
    {
      "context": "campaign",
      "abmStage": {
        "id": "cls3ghi789",
        "name": "MQL",
        "color": "#2196F3"
      },
      "previousStage": {
        "id": "cls1abc123",
        "name": "Engaged",
        "color": "#4CAF50"
      },
      "campaign": {
        "id": "cm7abmcamp1",
        "name": "Q1 Enterprise ABM Campaign"
      },
      "stageHistory": [
        {
          "stageId": "cls3ghi789",
          "stageName": "MQL",
          "color": "#2196F3",
          "date": "2025-09-01T11:00:00.000Z"
        },
        {
          "stageId": "cls1abc123",
          "stageName": "Engaged",
          "color": "#4CAF50",
          "date": "2025-06-15T08:45:00.000Z"
        }
      ],
      "latestChangeDate": "2025-09-01T11:00:00.000Z"
    }
  ],
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Campaigns

LinkedIn campaigns with performance metrics, company-level breakdowns, and job title insights.

||

List campaigns with insights

||
GET/campaigns

Returns a paginated list of LinkedIn campaigns with aggregated metrics. Optional filters: status (ACTIVE,PAUSED), abmCampaigns, intentId, campaignGroupId.

Request
curl "https://app.zenabm.com/api/v1/campaigns?period=last30Days&status=ACTIVE,PAUSED" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "1336",
      "name": "Techcrunch 2025",
      "status": "ACTIVE",
      "intent": null,
      "campaignGroup": {
        "id": "1337",
        "name": "Techcrunch 2025 CG"
      },
      "numberOfCompanies": 2833,
      "impressions": 128157,
      "clicks": 501,
      "engagements": 809,
      "costInUsd": 8202.59,
      "conversions": 213,
      "conversionRate": 0.183
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 472,
    "totalPages": 24
  },
  "meta": {
    "timestamp": "2026-03-09T19:06:51.685Z"
  }
}

Get campaign by ID

||
GET/campaigns/{id}

Request
curl "https://app.zenabm.com/api/v1/campaigns/{id}" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "id": "1337",
    "linkedInId": "330784953",
    "name": "Techcrunch 2025",
    "status": "ACTIVE",
    "dailyBudget": 90,
    "totalBudget": 0,
    "unitCost": 16,
    "currency": "USD",
    "linkedinCampaignGroupId": "1337",
    "syncStartDate": "2025-01-01T00:00:00.000Z",
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-09-15T00:00:00.000Z",
    "teamId": "1337",
    "intentId": null,
    "format": "STANDARD_UPDATE",
    "objectiveType": null,
    "costType": "CPM",
    "optimizationTarget": null,
    "pacingStrategy": null,
    "audienceExpansion": false,
    "linkedinCampaignGroup": {
      "id": "1337",
      "linkedInId": "710869393",
      "name": "Techcrunch 2025 CG",
      "status": "ACTIVE",
      "createdAt": "2025-01-01T00:00:00.000Z",
      "updatedAt": "2025-09-15T00:00:00.000Z",
      "teamId": "1337",
      "syncStartDate": "2025-01-01T00:00:00.000Z",
      "intentId": null
    },
    "intent": null
  },
  "meta": {
    "timestamp": "2026-03-09T19:09:39.624Z"
  }
}

Get campaign metrics overview

||
GET/campaigns/{id}/overview

Request
curl "https://app.zenabm.com/api/v1/campaigns/{id}/overview?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "summary": {
      "numberOfCompanies": 1578,
      "impressions": 102666,
      "clicks": 264,
      "engagements": 1136,
      "costInUsd": 4571.02,
      "conversions": 200,
      "conversionRate": 0.097
    },
    "weeklyData": [
      {
        "weekStart": "2025-09-08",
        "weekEnd": "2025-09-14",
        "impressions": 102666,
        "clicks": 264,
        "engagements": 1136,
        "costInUsd": 4571.02,
        "conversions": 199
      }
    ]
  },
  "meta": {
    "timestamp": "2026-03-09T19:08:06.843Z"
  }
}

List companies for a campaign

||
GET/campaigns/{id}/companies

Optional filters: sortBy, sortOrder, search

Request
curl "https://app.zenabm.com/api/v1/campaigns/{id}/companies?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "1337",
      "name": "Pied Piper",
      "city": "San Francisco",
      "country": "US",
      "website": "https://www.piedpiper.com/",
      "linkedInOrgId": "4827017",
      "hubspotCompanyId": "37411334702",
      "logoUrl": "https://piedpiper.com/assets/images/logo.png",
      "lifetimeEngagementScore": 2,
      "abmStage": {
        "id": "1337_aware",
        "name": "Aware",
        "color": "#A855F7",
        "displayOrder": 2
      },
      "lifetimeAbmStage": {
        "id": "1337_interested",
        "name": "Interested",
        "color": "#10B981",
        "displayOrder": 3
      },
      "impressions": 0,
      "clicks": 0,
      "engagements": 0,
      "costInUsd": 0,
      "clickThroughRate": 0,
      "costPerClick": 0,
      "cpm": 0,
      "intents": [],
      "abmCampaigns": [
        {
          "id": "1337",
          "name": "Techcrunch 2025"
        }
      ],
      "exclusion": null
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 501,
    "totalPages": 26
  },
  "meta": {
    "timestamp": "2026-03-09T19:10:47.810Z"
  }
}

Get job title insights for a campaign

||
GET/campaigns/{id}/job-titles

Returns job title engagement breakdown for a specific campaign.

Request
curl "https://app.zenabm.com/api/v1/campaigns/{id}/job-titles?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "jobTitleUrn": "urn:li:title:1337",
      "jobTitleName": "CEO",
      "impressions": 12450,
      "clicks": 87,
      "engagements": 342,
      "costInUsd": 891.45,
      "averageDwellTime": 4.2,
      "videoViews": null,
      "videoStarts": null,
      "videoFirstQuartileCompletions": null,
      "videoMidpointCompletions": null,
      "videoThirdQuartileCompletions": null,
      "videoCompletions": null,
      "exclusion": null
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 2,
    "totalPages": 1
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Campaign Groups

Campaign groups are logical groupings of LinkedIn campaigns with aggregated performance metrics.

||

List campaign groups with insights

||
GET/campaign-groups

Optional filters: status (ACTIVE,PAUSED), abmCampaigns, intentId

Request
curl "https://app.zenabm.com/api/v1/campaign-groups?period=last30Days&status=ACTIVE,PAUSED" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "1337",
      "name": "TechCrunch 2025",
      "status": "ACTIVE",
      "intent": {
        "id": "1337",
        "name": "Competitor"
      },
      "numberOfCampaigns": 21,
      "numberOfCompanies": 4374,
      "impressions": 583180,
      "clicks": 4838,
      "engagements": 30566,
      "costInUsd": 25033.73,
      "conversions": 1229,
      "clickConversions": 261,
      "viewConversions": 968,
      "conversionRate": 0.326
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 87,
    "totalPages": 5
  },
  "meta": {
    "timestamp": "2026-03-09T19:22:18.111Z"
  }
}

Get campaign group by ID

||
GET/campaign-groups/{id}

Request
curl "https://app.zenabm.com/api/v1/campaign-groups/{id}" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "id": "1337",
    "linkedInId": "734789393",
    "name": "TechCrunch 2025",
    "status": "ACTIVE",
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-09-15T00:00:00.000Z",
    "teamId": "1337",
    "syncStartDate": "2025-01-01T00:00:00.000Z",
    "intentId": "1337",
    "intent": {
      "id": "1337",
      "name": "Competitor",
      "description": "",
      "createdAt": "2025-01-01T00:00:00.000Z",
      "updatedAt": "2025-09-15T00:00:00.000Z",
      "teamId": "1337"
    }
  },
  "meta": {
    "timestamp": "2026-03-09T19:26:12.572Z"
  }
}

Get campaign group metrics overview

||
GET/campaign-groups/{id}/overview

Request
curl "https://app.zenabm.com/api/v1/campaign-groups/{id}/overview?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "summary": {
      "numberOfCompanies": 4374,
      "numberOfCampaigns": 21,
      "impressions": 583180,
      "clicks": 4838,
      "engagements": 30566,
      "costInUsd": 25033.73,
      "conversions": 1229,
      "conversionRate": 0.326
    },
    "weeklyData": [
      {
        "weekStart": "2025-03-03",
        "weekEnd": "2025-03-09",
        "impressions": 10976,
        "clicks": 168,
        "engagements": 189,
        "costInUsd": 337.89,
        "conversions": 53
      },
      {
        "weekStart": "2025-03-10",
        "weekEnd": "2025-03-16",
        "impressions": 13206,
        "clicks": 160,
        "engagements": 173,
        "costInUsd": 375.89,
        "conversions": 29
      }
    ]
  },
  "meta": {
    "timestamp": "2026-03-09T19:27:07.553Z"
  }
}

List companies for a campaign group

||
GET/campaign-groups/{id}/companies

Optional filters: sortBy, sortOrder, search

Request
curl "https://app.zenabm.com/api/v1/campaign-groups/{id}/companies?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "1337",
      "name": "Pied Piper",
      "city": "San Francisco",
      "country": "US",
      "website": "https://www.piedpiper.com/",
      "linkedInOrgId": "4827017",
      "hubspotCompanyId": "37411334702",
      "logoUrl": "https://piedpiper.com/assets/images/logo.png",
      "lifetimeEngagementScore": 2,
      "impressions": 47759,
      "clicks": 273,
      "engagements": 2380,
      "costInUsd": 1580.19,
      "clickThroughRate": 0.572,
      "costPerClick": 5.79,
      "cpm": 33.09,
      "intents": [
        {
          "id": "1337",
          "name": "Competitor"
        }
      ],
      "abmStage": {
        "id": "1337_interested",
        "name": "Interested",
        "color": "#10B981",
        "displayOrder": 3
      },
      "lifetimeAbmStage": {
        "id": "1337_interested",
        "name": "Interested",
        "color": "#10B981",
        "displayOrder": 3
      },
      "abmCampaigns": [
        {
          "id": "1337",
          "name": "TechCrunch 2025"
        }
      ],
      "exclusion": null
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 4101,
    "totalPages": 206
  },
  "meta": {
    "timestamp": "2026-03-09T19:28:09.356Z"
  }
}

Get job title insights for a campaign group

||
GET/campaign-groups/{id}/job-titles

Optional filters: sortBy, sortOrder

Request
curl "https://app.zenabm.com/api/v1/campaign-groups/{id}/job-titles?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "jobTitleUrn": "urn:li:title:123",
      "jobTitleName": "VP of Marketing",
      "impressions": 12450,
      "clicks": 87,
      "engagements": 342,
      "costInUsd": 891.45,
      "averageDwellTime": 4.2,
      "videoViews": null,
      "videoStarts": null,
      "videoFirstQuartileCompletions": null,
      "videoMidpointCompletions": null,
      "videoThirdQuartileCompletions": null,
      "videoCompletions": null,
      "exclusion": null
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 2,
    "totalPages": 1
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Deals

CRM deals synced with ZenABM. Includes LinkedIn and ABM influence attribution to measure pipeline impact.

||

List deals with insights

||
GET/deals

Returns a paginated list of CRM deals with influence attribution data.

Request
curl "https://app.zenabm.com/api/v1/deals?dateFrom=2025-01-01&dateTo=2025-12-31&influenceFilter=LINKEDIN,ABM" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "clxyz789deal",
      "dealName": "Hooli - Enterprise License",
      "hubspotId": "12345678",
      "hubspotPortalId": "98765432",
      "company": {
        "id": "cm7abc123",
        "name": "Hooli",
        "logoUrl": "https://media.licdn.com/dms/image/hooli-logo.png",
        "website": "https://hooli.com",
        "linkedInOrgId": "12345"
      },
      "amount": 45000,
      "linkedinInfluenced": true,
      "abmInfluenced": true,
      "hubspotCreatedAt": "2025-03-15T10:30:00.000Z",
      "hubspotClosedAt": "2025-06-20T14:00:00.000Z",
      "stage": {
        "id": "cls123stage",
        "name": "Closed Won"
      },
      "campaigns": [
        {
          "id": "cm7abm1",
          "name": "Q1 Enterprise ABM"
        }
      ],
      "impressionsBeforeDeal": 8450,
      "clicksBeforeDeal": 142,
      "engagementsBeforeDeal": 312
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 1,
    "totalPages": 1
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Job Titles

Analyze which job titles are engaging with your ads. Understand your audience at the persona level.

||

List job titles with insights

||
GET/job-titles

Optional filters: campaigns (comma-separated IDs), campaignGroups (comma-separated IDs)

Request
curl "https://app.zenabm.com/api/v1/job-titles?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "jobTitleUrn": "urn:li:title:123",
      "jobTitleName": "VP of Marketing",
      "impressions": 12450,
      "clicks": 87,
      "engagements": 342,
      "costInUsd": 891.45,
      "averageDwellTime": 4.2,
      "videoViews": null,
      "videoStarts": null,
      "videoFirstQuartileCompletions": null,
      "videoMidpointCompletions": null,
      "videoThirdQuartileCompletions": null,
      "videoCompletions": null,
      "exclusion": null
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 1,
    "totalPages": 1
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Get job title by ID

||
GET/job-titles/{id}

Request
curl "https://app.zenabm.com/api/v1/job-titles/{id}" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "urn": "urn:li:title:123",
    "name": "VP of Marketing",
    "createdAt": "2025-01-10T08:00:00.000Z",
    "updatedAt": "2025-06-15T12:00:00.000Z"
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Get campaign insights for a job title

||
GET/job-titles/{id}/campaigns

Optional filters: sortBy, sortOrder, search

Request
curl "https://app.zenabm.com/api/v1/job-titles/{id}/campaigns?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "data": [
      {
        "campaignId": "1337",
        "campaignName": "TechCrunch 2025",
        "impressions": 12450,
        "clicks": 87,
        "engagements": 342,
        "costInUsd": 891.45,
        "averageDwellTime": 4.2,
        "videoViews": 0,
        "videoStarts": 0,
        "videoFirstQuartileCompletions": 0,
        "videoMidpointCompletions": 0,
        "videoThirdQuartileCompletions": 0,
        "videoCompletions": 0
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "totalCount": 1,
      "totalPages": 1
    }
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Get campaign group insights for a job title

||
GET/job-titles/{id}/campaign-groups

Optional filters: sortBy, sortOrder, search

Request
curl "https://app.zenabm.com/api/v1/job-titles/{id}/campaign-groups?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "data": [
      {
        "campaignGroupId": "1337",
        "campaignGroupName": "TechCrunch 2025 CG",
        "impressions": 12450,
        "clicks": 87,
        "engagements": 342,
        "costInUsd": 891.45,
        "averageDwellTime": 4.2,
        "videoViews": 0,
        "videoStarts": 0,
        "videoFirstQuartileCompletions": 0,
        "videoMidpointCompletions": 0,
        "videoThirdQuartileCompletions": 0,
        "videoCompletions": 0
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "totalCount": 1,
      "totalPages": 1
    }
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

ABM Campaigns

ABM campaigns are high-level campaign groupings with funnel stage tracking and overview metrics.

||

List ABM campaigns with insights

||
GET/abm-campaigns

Optional filters: status (ACTIVE,PAUSED,COMPLETED)

Request
curl "https://app.zenabm.com/api/v1/abm-campaigns?period=last30Days&status=ACTIVE" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "cm7abm001",
      "name": "Q1 Enterprise ABM Campaign",
      "status": "ACTIVE",
      "startDate": "2025-01-15T00:00:00.000Z",
      "endDate": "2025-06-30T00:00:00.000Z",
      "description": "Targeting enterprise accounts in fintech",
      "teamId": "team123",
      "numberOfTargetAccounts": 120,
      "createdAt": "2025-01-10T08:00:00.000Z",
      "updatedAt": "2025-03-01T12:00:00.000Z",
      "numberOfLinkedInCampaigns": 5,
      "numberOfLinkedInCampaignGroups": 2,
      "companiesTargeted": 85,
      "totalPipeline": 450000,
      "totalRevenue": 180000,
      "totalAdSpend": 12500,
      "pipePerSpent": 36,
      "averageAcv": 45000,
      "roas": 14.4
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 1,
    "totalPages": 1
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Get ABM campaign by ID

||
GET/abm-campaigns/{id}

Request
curl "https://app.zenabm.com/api/v1/abm-campaigns/{id}" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "abmCampaign": {
      "id": "1337",
      "name": "Silicon Valley 2025",
      "status": "ACTIVE",
      "startDate": "2025-01-15T00:00:00.000Z",
      "endDate": "2025-06-30T00:00:00.000Z",
      "description": "Targeting enterprise accounts in fintech",
      "teamId": "team123",
      "numberOfTargetAccounts": 120,
      "createdAt": "2025-01-10T08:00:00.000Z",
      "updatedAt": "2025-03-01T12:00:00.000Z",
      "linkedInCampaigns": [
        {
          "id": "1337",
          "name": "Silicon Valley 2025"
        }
      ],
      "linkedInCampaignGroups": [
        {
          "id": "1337",
          "name": "Silicon Valley 2025 CG"
        }
      ]
    },
    "linkedInCampaigns": [
      {
        "id": "1337",
        "name": "Silicon Valley 2025"
      }
    ],
    "linkedInCampaignGroups": [
      {
        "id": "1337",
        "name": "Silicon Valley 2025 CG"
      }
    ]
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Get ABM campaign layout overview

||
GET/abm-campaigns/{id}/overview

Request
curl "https://app.zenabm.com/api/v1/abm-campaigns/{id}/overview" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "id": "1337",
    "name": "Silicon Valley 2025",
    "status": "ACTIVE",
    "startDate": "2025-01-15T00:00:00.000Z",
    "endDate": "2025-06-30T00:00:00.000Z",
    "description": "Targeting enterprise accounts in fintech",
    "numberOfTargetAccounts": 120,
    "numberOfLinkedInCampaigns": 5,
    "numberOfLinkedInCampaignGroups": 2
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Get ABM campaign stages breakdown

||
GET/abm-campaigns/{id}/stages-breakdown

Returns a breakdown of companies across each ABM funnel stage.

Request
curl "https://app.zenabm.com/api/v1/abm-campaigns/{id}/stages-breakdown?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "data": [
      {
        "stageId": "1337",
        "stageName": "Aware",
        "color": "#FFC107",
        "isConfigured": true,
        "currentPeriod": 45,
        "previousPeriod": 32,
        "change": 13,
        "changePercentage": 40.6
      }
    ],
    "viewType": "unified",
    "periods": {
      "current": {
        "label": "Mar 2025",
        "dateRange": {
          "from": "2025-03-01",
          "to": "2025-03-31"
        }
      },
      "previous": {
        "label": "Feb 2025",
        "dateRange": {
          "from": "2025-02-01",
          "to": "2025-02-28"
        }
      }
    }
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

List companies for an ABM campaign

||
GET/abm-campaigns/{id}/companies

Returns a paginated list of companies with engagement metrics and intent data for a specific ABM campaign. Aggregates data from all linked LinkedIn campaigns and campaign groups.

Request
curl "https://app.zenabm.com/api/v1/abm-campaigns/{id}/companies?period=last30Days&engagementScores=3,4,5&crmMatchStatus=all" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "1337",
      "name": "Pied Piper",
      "city": "Palo Alto",
      "country": "US",
      "website": "https://www.piedpiper.com/",
      "linkedInOrgId": "4827017",
      "hubspotCompanyId": "37411334702",
      "lifetimeEngagementScore": 3,
      "logoUrl": "https://piedpiper.com/assets/images/logo.png",
      "abmStage": {
        "id": "1337_interested",
        "name": "Interested",
        "color": "#10B981",
        "displayOrder": 3,
        "isManuallyOverridden": false,
        "overrideTimestamp": null
      },
      "lifetimeAbmStage": {
        "id": "1337_interested",
        "name": "Interested",
        "color": "#10B981",
        "displayOrder": 3
      },
      "intents": [
        {
          "id": "cm9iaw4a50001jr04wqc1k4dt",
          "name": "Competitor"
        }
      ],
      "impressions": 109198,
      "clicks": 468,
      "engagements": 2769,
      "costInUsd": 2797.37,
      "currentEngagementScore": 2,
      "abmCampaigns": [
        {
          "id": "1337",
          "name": "Techcrunch 2025"
        }
      ],
      "exclusion": null
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 85,
    "totalPages": 5
  },
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z"
  }
}

List job titles for an ABM campaign

||
GET/abm-campaigns/{id}/job-titles

Returns a paginated list of job titles with engagement metrics for a specific ABM campaign. Aggregates data from all linked LinkedIn campaigns and campaign groups.

Request
curl "https://app.zenabm.com/api/v1/abm-campaigns/{id}/job-titles?period=last30Days" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "jobTitleUrn": "urn:li:title:123",
      "jobTitleName": "VP of Marketing",
      "impressions": 12450,
      "clicks": 87,
      "engagements": 342,
      "costInUsd": 891.45,
      "averageDwellTime": 4.2,
      "videoViews": null,
      "videoStarts": null,
      "videoFirstQuartileCompletions": null,
      "videoMidpointCompletions": null,
      "videoThirdQuartileCompletions": null,
      "videoCompletions": null,
      "exclusion": null
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 45,
    "totalPages": 3
  },
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z"
  }
}

ABM Stages

ABM funnel stages — track companies entering, progressing through, and the history of each stage.

||

List ABM stages

||
GET/abm-stages
Request
curl "https://app.zenabm.com/api/v1/abm-stages" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "cls1abc",
      "name": "Aware",
      "color": "#FFC107",
      "displayOrder": 1,
      "createdAt": "2025-01-05T08:00:00.000Z",
      "updatedAt": "2025-01-05T08:00:00.000Z"
    },
    {
      "id": "cls2def",
      "name": "Engaged",
      "color": "#4CAF50",
      "displayOrder": 2,
      "createdAt": "2025-01-05T08:00:00.000Z",
      "updatedAt": "2025-01-05T08:00:00.000Z"
    }
  ],
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Get ABM stage by ID with statistics

||
GET/abm-stages/{id}

Request
curl "https://app.zenabm.com/api/v1/abm-stages/{id}" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "id": "cls1abc",
    "name": "Aware",
    "color": "#FFC107",
    "displayOrder": 1,
    "createdAt": "2025-01-05T08:00:00.000Z",
    "updatedAt": "2025-01-05T08:00:00.000Z",
    "statistics": {
      "currentCompaniesCount": 45,
      "companiesEntered": 12,
      "companiesLeft": 3
    }
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

List companies currently in an ABM stage

||
GET/abm-stages/{id}/companies

Returns a paginated list of companies whose current ABM stage matches the given stage ID. Supports search and sorting.

Request
curl "https://app.zenabm.com/api/v1/abm-stages/{id}/companies" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "1337",
      "name": "Pied Piper",
      "city": "Palo Alto",
      "country": "US",
      "website": "https://www.piedpiper.com/",
      "linkedInOrgId": "4827017",
      "hubspotCompanyId": "37411334702",
      "logoUrl": "https://piedpiper.com/assets/images/logo.png",
      "lifetimeEngagementScore": 3,
      "abmStage": {
        "id": "1337_interested",
        "name": "Interested",
        "color": "#10B981",
        "displayOrder": 3
      },
      "lifetimeAbmStage": {
        "id": "1337_interested",
        "name": "Interested",
        "color": "#10B981",
        "displayOrder": 3
      }
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 45,
    "totalPages": 3
  },
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z"
  }
}

Get companies entering an ABM stage

||
GET/abm-stages/{id}/companies-entering

Request
curl "https://app.zenabm.com/api/v1/abm-stages/{id}/companies-entering" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "companies": [
      {
        "id": "cm7abc123",
        "name": "Acme Corp",
        "logoUrl": "https://media.licdn.com/dms/image/acme-logo.png",
        "website": "https://acme.com",
        "hubspotCompanyId": "9876543",
        "country": "United States",
        "previousStage": {
          "id": "cls1abc",
          "name": "Aware",
          "color": "#FFC107"
        },
        "dateEntered": "2025-08-12T09:30:00.000Z"
      },
      {
        "id": "cm7xyz456",
        "name": "Globex Industries",
        "logoUrl": "https://media.licdn.com/dms/image/globex-logo.png",
        "website": "https://globex.com",
        "hubspotCompanyId": "1234567",
        "country": "Germany",
        "previousStage": null,
        "dateEntered": "2025-07-20T14:15:00.000Z"
      }
    ],
    "hubspotPortalId": "98765432"
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Get companies progressing from an ABM stage

||
GET/abm-stages/{id}/companies-progressing

Request
curl "https://app.zenabm.com/api/v1/abm-stages/{id}/companies-progressing" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "companies": [
      {
        "id": "cm7abc123",
        "name": "Acme Corp",
        "website": "https://acme.com",
        "country": "United States",
        "linkedInOrgId": "12345",
        "logoUrl": "https://media.licdn.com/dms/image/acme-logo.png",
        "hubspotCompanyId": "9876543",
        "nextStage": {
          "id": "cls3ghi",
          "name": "MQL",
          "color": "#2196F3"
        },
        "dateLeft": "2025-09-01T11:00:00.000Z"
      }
    ],
    "hubspotPortalId": "98765432",
    "totalCount": 1
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Get ABM stage history

||
GET/abm-stages/{id}/history

Request
curl "https://app.zenabm.com/api/v1/abm-stages/{id}/history" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "csh001",
      "companyId": "cm7abc123",
      "abmStageId": "cls2def",
      "previousStageId": "cls1abc",
      "createdAt": "2025-08-12T09:30:00.000Z",
      "company": {
        "id": "cm7abc123",
        "name": "Acme Corp"
      },
      "abmStage": {
        "id": "cls2def",
        "name": "Engaged",
        "color": "#4CAF50"
      },
      "previousStage": {
        "id": "cls1abc",
        "name": "Aware",
        "color": "#FFC107"
      }
    },
    {
      "id": "csh002",
      "companyId": "cm7xyz456",
      "abmStageId": "cls2def",
      "previousStageId": null,
      "createdAt": "2025-07-20T14:15:00.000Z",
      "company": {
        "id": "cm7xyz456",
        "name": "Globex Industries"
      },
      "abmStage": {
        "id": "cls2def",
        "name": "Engaged",
        "color": "#4CAF50"
      },
      "previousStage": null
    }
  ],
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Intents

Intent signals configured for your team — used to qualify and prioritize target accounts.

||

List intents

||
GET/intents
Request
curl "https://app.zenabm.com/api/v1/intents" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": [
    {
      "id": "int001",
      "name": "Product Demo Interest",
      "teamId": "team123",
      "createdAt": "2025-02-01T10:00:00.000Z",
      "updatedAt": "2025-05-15T14:00:00.000Z",
      "campaigns": [
        {
          "id": "cm7lc001",
          "name": "Evergreen 2025 - Competitor Switching"
        }
      ],
      "campaignGroups": [
        {
          "id": "cm7lcg001",
          "name": "Fintech Enterprise Group"
        }
      ]
    }
  ],
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Get intent by ID

||
GET/intents/{id}

Request
curl "https://app.zenabm.com/api/v1/intents/{id}" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "id": "int001",
    "name": "Product Demo Interest",
    "teamId": "team123",
    "createdAt": "2025-02-01T10:00:00.000Z",
    "updatedAt": "2025-05-15T14:00:00.000Z",
    "campaigns": [
      {
        "id": "cm7lc001",
        "name": "Evergreen 2025 - Competitor Switching"
      }
    ],
    "campaignGroups": [
      {
        "id": "cm7lcg001",
        "name": "Fintech Enterprise Group"
      }
    ]
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Dashboard

Dashboard-level aggregate metrics — top companies, ad spend, and overall performance at a glance.

||

Get dashboard overview

||
GET/dashboard

Returns a high-level overview with top companies, total metrics, and ad spend for the given date range.

Request
curl "https://app.zenabm.com/api/v1/dashboard" \
  -H "Authorization: Bearer sk_live_xxx"
Response
{
  "data": {
    "topEngagedCompanies": [
      {
        "id": "1337",
        "name": "Pied Piper",
        "city": "San Francisco",
        "country": "United States",
        "website": "https://piedpiper.com",
        "logoUrl": "https://piedpiper.com/assets/images/logo.png",
        "linkedInOrgId": "12345",
        "hubspotCompanyId": "9876543",
        "impressions": 24500,
        "clicks": 312,
        "engagements": 890,
        "costInUsd": 3450.75,
        "lifetimeEngagementScore": 87,
        "lifetimeAbmStage": null,
        "abmStage": {
          "id": "cls2def",
          "name": "Engaged",
          "color": "#4CAF50",
          "displayOrder": 2
        },
        "intents": [
          {
            "id": "int001",
            "name": "Product Demo Interest"
          }
        ],
        "abmCampaigns": [
          {
            "id": "cm7abm001",
            "name": "Q1 Enterprise ABM"
          }
        ]
      }
    ],
    "linkedInMetrics": {
      "current": {
        "impressions": 145000,
        "clicks": 2100,
        "engagements": 5800,
        "costInUsd": 28500
      },
      "previous": {
        "impressions": 120000,
        "clicks": 1800,
        "engagements": 4900,
        "costInUsd": 24000
      }
    }
  },
  "meta": {
    "timestamp": "2026-03-09T12:00:00.000Z"
  }
}

Need help?

Our team can help with integration, debugging, or custom endpoint requests.

Contact support
Rate limits
{
  "rateLimit": {
    "requests": "100/min",
    "headers": {
      "X-RateLimit-Limit": 100,
      "X-RateLimit-Remaining": 97
    }
  }
}

©2026 ZenABM - All Rights Reserved.