# HeyReach

> Run your HeyReach LinkedIn outreach: add leads to campaigns and lists, pause or resume campaigns, read and answer inbox conversations, tag leads and get outreach stats.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/heyreach

## Actions

### Add lead to campaign

Add a lead to a campaign by their LinkedIn profile, so the campaign reaches out to them. A lead already in it is updated.

**Inputs**

- Campaign (`campaign_id`, text, required): The campaign. Pick one, or give its id from an earlier step.
- LinkedIn profile (`profile_url`, text, required): The lead's LinkedIn profile address.
- LinkedIn sender (`linkedin_account_id`, text): The campaign's sender who should reach this lead. Leave empty to let HeyReach choose.
- First name (`first_name`, text): The lead's first name.
- Last name (`last_name`, text): The lead's last name.
- Email (`email`, text): The lead's email address.
- Company (`company_name`, text): Where the lead works.
- Job title (`position`, text): The lead's job title.
- Location (`location`, text): Where the lead is based.
- About (`about`, text): A note about the lead, usable in message templates.
- Custom fields (`custom_fields`, object): Your own fields for message templates, such as {"favorite_color": "blue"}. Names use only letters, digits and _.
- Resume if paused (`resume_paused_campaign`, text): Resume the campaign if it is paused. Defaults to no. One of: `true` (Yes), `false` (No).
- Resume if finished (`resume_finished_campaign`, text): Start the campaign again if it has finished. Defaults to no. One of: `true` (Yes), `false` (No).

**Outputs**

- `added_count` (number): 1 if the lead is new
- `campaign_id` (number): The campaign
- `failed_count` (number): Leads HeyReach could not add
- `profile_url` (text): The lead's profile address
- `updated_count` (number): 1 if it was already there

**Example output**

```json
{
  "added_count": 1,
  "campaign_id": 274079,
  "failed_count": 0,
  "profile_url": "https://www.linkedin.com/in/jane-doe",
  "updated_count": 0
}
```

### Add lead to list

Add a lead to a lead list by their LinkedIn profile. This does not start a campaign for them; use 'Add lead to campaign' for that.

**Inputs**

- List (`list_id`, text, required): The lead list. Pick one, or give its id from an earlier step.
- LinkedIn profile (`profile_url`, text, required): The lead's LinkedIn profile address.
- First name (`first_name`, text): The lead's first name.
- Last name (`last_name`, text): The lead's last name.
- Email (`email`, text): The lead's email address.
- Company (`company_name`, text): Where the lead works.
- Job title (`position`, text): The lead's job title.
- Location (`location`, text): Where the lead is based.
- About (`about`, text): A note about the lead, usable in message templates.
- Custom fields (`custom_fields`, object): Your own fields for message templates, such as {"favorite_color": "blue"}. Names use only letters, digits and _.

**Outputs**

- `added_count` (number): 1 if the lead is new
- `failed_count` (number): Leads HeyReach could not add
- `list_id` (number): The list
- `profile_url` (text): The lead's profile address
- `updated_count` (number): 1 if it was already there

**Example output**

```json
{
  "added_count": 1,
  "failed_count": 0,
  "list_id": 3457,
  "profile_url": "https://www.linkedin.com/in/jane-doe",
  "updated_count": 0
}
```

### Create list

Create an empty lead list (or company list) to add leads to.

**Inputs**

- Name (`name`, text, required): The list's name.
- Type (`list_type`, text): A list of people or of companies. Defaults to people. One of: `USER_LIST` (Lead list), `COMPANY_LIST` (Company list).

**Outputs**

- `list` (object): The new list

**Example output**

```json
{
  "list": {
    "count": 0,
    "creationTime": "2026-10-04T09:34:56Z",
    "id": 3458,
    "listType": "USER_LIST",
    "name": "Event leads",
    "status": "UNKNOWN"
  }
}
```

### Get campaign

Get one campaign with its status, lead list, senders and how many leads are in progress, finished or failed.

**Inputs**

- Campaign (`campaign_id`, text, required): The campaign. Pick one, or give its id from an earlier step.

**Outputs**

- `campaign` (object): The campaign

**Example output**

```json
{
  "campaign": {
    "campaignAccountIds": [
      113298
    ],
    "creationTime": "2026-10-01T08:06:15Z",
    "excludeListId": 0,
    "id": 274079,
    "linkedInUserListId": 123456,
    "linkedInUserListName": "Webinar leads",
    "name": "My First Campaign",
    "progressStats": {
      "totalUsers": 9,
      "totalUsersExcluded": 0,
      "totalUsersFailed": 0,
      "totalUsersFinished": 1,
      "totalUsersInProgress": 8,
      "totalUsersManuallyStopped": 0,
      "totalUsersPending": 0
    },
    "status": "IN_PROGRESS"
  }
}
```

### Get conversation

Get one LinkedIn conversation with all its messages.

**Inputs**

- LinkedIn sender (`linkedin_account_id`, text, required): The LinkedIn account in HeyReach the conversation belongs to. Pick one, or give its id from 'List conversations'.
- Conversation ID (`conversation_id`, text, required): The conversation's id, from 'List conversations' or a trigger.

**Outputs**

- `conversation` (object): The conversation

**Example output**

```json
{
  "conversation": {
    "correspondentProfile": {
      "about": "",
      "companyName": "Acme",
      "companyUrl": "https://www.linkedin.com/company/acme",
      "connections": 500,
      "customFields": [
        {
          "name": "favorite_color",
          "value": "blue"
        }
      ],
      "emailAddress": "jane@example.com",
      "firstName": "Jane",
      "followers": 820,
      "headline": "Head of Marketing at Acme",
      "imageUrl": "https://media.licdn.com/dms/image/jane.jpg",
      "lastName": "Doe",
      "linkedin_id": "58344979",
      "location": "Austin, Texas",
      "position": "Head of Marketing",
      "profileUrl": "https://www.linkedin.com/in/jane-doe",
      "tags": [
        "webinar"
      ]
    },
    "groupChat": false,
    "id": "2-ODM0YmIzNzgtOGEyOS00ZTYz",
    "lastMessageAt": "2026-10-03T12:00:19Z",
    "lastMessageSender": "CORRESPONDENT",
    "lastMessageText": "Thanks, happy to chat next week.",
    "lastMessageType": "TEXT",
    "linkedInAccount": {
      "authIsValid": true,
      "emailAddress": "sam@example.com",
      "firstName": "Sam",
      "id": 113298,
      "lastName": "Seller",
      "profileUrl": "https://www.linkedin.com/in/sam-seller"
    },
    "linkedInAccountId": 113298,
    "messages": [
      {
        "body": "Hi Jane, loved your webinar.",
        "createdAt": "2026-10-02T09:00:00Z",
        "isInMail": false,
        "postLink": "",
        "sender": "ME",
        "subject": ""
      },
      {
        "body": "Thanks, happy to chat next week.",
        "createdAt": "2026-10-03T12:00:19Z",
        "isInMail": false,
        "postLink": "",
        "sender": "CORRESPONDENT",
        "subject": ""
      }
    ],
    "read": false,
    "totalMessages": 2
  }
}
```

### Get lead

Get what HeyReach knows about a lead from their LinkedIn profile: name, job, company, location and any email found.

**Inputs**

- LinkedIn profile (`profile_url`, text, required): The lead's LinkedIn profile address.

**Outputs**

- `lead` (object): The lead

**Example output**

```json
{
  "lead": {
    "about": "",
    "companyName": "Acme",
    "companyUrl": "https://www.linkedin.com/company/acme",
    "connections": 500,
    "emailAddress": "jane@example.com",
    "enrichedEmailAddress": "jane@acme.example",
    "firstName": "Jane",
    "followers": 820,
    "fullName": "Jane Doe",
    "headline": "Head of Marketing at Acme",
    "imageUrl": "https://media.licdn.com/dms/image/jane.jpg",
    "industry": "Software",
    "lastName": "Doe",
    "linkedin_id": "58344979",
    "location": "Austin, Texas",
    "position": "Head of Marketing",
    "profileUrl": "https://www.linkedin.com/in/jane-doe",
    "summary": "",
    "username": "jane-doe"
  }
}
```

### Get list

Get one list with its type, size and the campaigns using it.

**Inputs**

- List (`list_id`, text, required): The lead list. Pick one, or give its id from an earlier step.

**Outputs**

- `list` (object): The list

**Example output**

```json
{
  "list": {
    "campaignIds": [
      274079
    ],
    "creationTime": "2026-09-30T09:34:56Z",
    "id": 3457,
    "listType": "USER_LIST",
    "name": "Webinar leads",
    "totalItemsCount": 120
  }
}
```

### Get outreach stats

Get invitations sent and accepted, messages, replies, InMails and reply rates, in total and day by day, for all or some senders and campaigns.

**Inputs**

- From (`start_date`, date): The first day. Defaults to six days before the last day.
- To (`end_date`, date): The last day, included. Defaults to today (UTC).
- LinkedIn senders (`linkedin_account_ids`, list): Only these senders. Leave empty for all of them.
- Campaigns (`campaign_ids`, list): Only these campaigns. Leave empty for all of them.

**Outputs**

- `count` (number): How many days
- `days` (list): The figures for each day
- `end_date` (text): Last day (YYYY-MM-DD)
- `overall` (object): Totals for the whole range
- `start_date` (text): First day (YYYY-MM-DD)

**Example output**

```json
{
  "count": 1,
  "days": [
    {
      "connectionAcceptanceRate": 0.26,
      "connectionsAccepted": 31,
      "connectionsSent": 120,
      "date": "2026-10-01",
      "follows": 1,
      "inMailReplyRate": 0.0,
      "inmailMessagesSent": 0,
      "messageReplyRate": 0.3,
      "messagesSent": 40,
      "postLikes": 3,
      "profileViews": 12,
      "totalInmailReplies": 0,
      "totalInmailStarted": 0,
      "totalMessageReplies": 9,
      "totalMessageStarted": 30
    }
  ],
  "end_date": "2026-10-01",
  "overall": {
    "connectionAcceptanceRate": 0.26,
    "connectionsAccepted": 31,
    "connectionsSent": 120,
    "follows": 1,
    "inMailReplyRate": 0.0,
    "inmailMessagesSent": 0,
    "messageReplyRate": 0.3,
    "messagesSent": 40,
    "postLikes": 3,
    "profileViews": 12,
    "totalInmailReplies": 0,
    "totalInmailStarted": 0,
    "totalMessageReplies": 9,
    "totalMessageStarted": 30
  },
  "start_date": "2026-10-01"
}
```

### List campaign leads

List a campaign's leads with where each is in the sequence, whether they accepted the invitation and whether they replied. Gets one page; to see more, run it again with the next offset.

**Inputs**

- Campaign (`campaign_id`, text, required): The campaign. Pick one, or give its id from an earlier step.
- Time range applies to (`time_filter`, text): What the From and To times filter on. Defaults to when the lead was added. One of: `CreationTime` (Added to the campaign), `LastActionTakenTime` (Last action taken), `FailedTime` (Failed), `LastActionTakenOrFailedTime` (Last action taken or failed).
- From (`time_from`, date and time): Only leads from this time on.
- To (`time_to`, date and time): Only leads up to this time.
- Skip (`offset`, number): How many to skip, for the next page: give the 'next_offset' an earlier run returned. Defaults to 0. At least 0.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 100. From 1 to 100.

**Outputs**

- `campaign_id` (number): The campaign
- `count` (number): How many on this page
- `has_more` (true/false): Whether there is another page
- `leads` (list): The campaign's leads
- `next_offset` (number): The offset to give for the next page
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "campaign_id": 274079,
  "count": 1,
  "has_more": false,
  "leads": [
    {
      "creationTime": "2026-10-01T21:28:06Z",
      "failedTime": "",
      "id": 62658,
      "lastActionTime": "2026-10-02T03:28:22Z",
      "leadCampaignStatus": "InSequence",
      "leadCampaignStatusMessage": "",
      "leadConnectionStatus": "ConnectionAccepted",
      "leadMessageStatus": "MessageSent",
      "linkedInSenderFullName": "Sam Seller",
      "linkedInSenderId": 113298,
      "linkedInUserProfile": {
        "about": "",
        "companyName": "Acme",
        "companyUrl": "https://www.linkedin.com/company/acme",
        "connections": 500,
        "customFields": [
          {
            "name": "favorite_color",
            "value": "blue"
          }
        ],
        "emailAddress": "jane@example.com",
        "firstName": "Jane",
        "followers": 820,
        "headline": "Head of Marketing at Acme",
        "imageUrl": "https://media.licdn.com/dms/image/jane.jpg",
        "lastName": "Doe",
        "linkedin_id": "58344979",
        "location": "Austin, Texas",
        "position": "Head of Marketing",
        "profileUrl": "https://www.linkedin.com/in/jane-doe",
        "tags": [
          "webinar"
        ]
      },
      "linkedInUserProfileId": "AC9sANasX0Ia"
    }
  ],
  "next_offset": 1,
  "total_count": 1
}
```

### List campaigns

List campaigns with their status, lead list, senders and progress, filtered by name, status or sender. Gets one page; to see more, run it again with the next offset it gives.

**Inputs**

- Name contains (`keyword`, text): Only those whose name contains this text.
- Statuses (`statuses`, list): Only campaigns in these states. Leave empty for all. One or more of: `DRAFT`, `STARTING`, `SCHEDULED`, `IN_PROGRESS` (In progress), `PAUSED`, `FINISHED`, `CANCELED`, `FAILED`.
- LinkedIn senders (`linkedin_account_ids`, list): Only these senders. Leave empty for all of them.
- Skip (`offset`, number): How many to skip, for the next page: give the 'next_offset' an earlier run returned. Defaults to 0. At least 0.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 100. From 1 to 100.

**Outputs**

- `campaigns` (list): The campaigns
- `count` (number): How many on this page
- `has_more` (true/false): Whether there is another page
- `next_offset` (number): The offset to give for the next page
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "campaigns": [
    {
      "campaignAccountIds": [
        113298
      ],
      "creationTime": "2026-10-01T08:06:15Z",
      "excludeListId": 0,
      "id": 274079,
      "linkedInUserListId": 123456,
      "linkedInUserListName": "Webinar leads",
      "name": "My First Campaign",
      "progressStats": {
        "totalUsers": 9,
        "totalUsersExcluded": 0,
        "totalUsersFailed": 0,
        "totalUsersFinished": 1,
        "totalUsersInProgress": 8,
        "totalUsersManuallyStopped": 0,
        "totalUsersPending": 0
      },
      "status": "IN_PROGRESS"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_offset": 1,
  "total_count": 1
}
```

### List conversations

List LinkedIn conversations from the HeyReach inbox with their latest messages, filtered by sender, campaign, lead, tag or read state. Gets one page; to see more, run it again with the next offset.

**Inputs**

- LinkedIn senders (`linkedin_account_ids`, list): Only these senders. Leave empty for all of them.
- Campaigns (`campaign_ids`, list): Only these campaigns. Leave empty for all of them.
- Search (`search`, text): Only conversations matching this text.
- Lead's LinkedIn profile (`lead_profile_url`, text): Only conversations with this lead.
- Lead tags (`tags`, list): Only leads with at least one of these tags.
- Read state (`seen`, text): Read, unread or both. Defaults to both. One of: `any` (Read and unread (default)), `unseen` (Unread only), `seen` (Read only).
- Skip (`offset`, number): How many to skip, for the next page: give the 'next_offset' an earlier run returned. Defaults to 0. At least 0.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 100. From 1 to 100.

**Outputs**

- `conversations` (list): The conversations
- `count` (number): How many on this page
- `has_more` (true/false): Whether there is another page
- `next_offset` (number): The offset to give for the next page
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "conversations": [
    {
      "correspondentProfile": {
        "about": "",
        "companyName": "Acme",
        "companyUrl": "https://www.linkedin.com/company/acme",
        "connections": 500,
        "customFields": [
          {
            "name": "favorite_color",
            "value": "blue"
          }
        ],
        "emailAddress": "jane@example.com",
        "firstName": "Jane",
        "followers": 820,
        "headline": "Head of Marketing at Acme",
        "imageUrl": "https://media.licdn.com/dms/image/jane.jpg",
        "lastName": "Doe",
        "linkedin_id": "58344979",
        "location": "Austin, Texas",
        "position": "Head of Marketing",
        "profileUrl": "https://www.linkedin.com/in/jane-doe",
        "tags": [
          "webinar"
        ]
      },
      "groupChat": false,
      "id": "2-ODM0YmIzNzgtOGEyOS00ZTYz",
      "lastMessageAt": "2026-10-03T12:00:19Z",
      "lastMessageSender": "CORRESPONDENT",
      "lastMessageText": "Thanks, happy to chat next week.",
      "lastMessageType": "TEXT",
      "linkedInAccount": {
        "authIsValid": true,
        "emailAddress": "sam@example.com",
        "firstName": "Sam",
        "id": 113298,
        "lastName": "Seller",
        "profileUrl": "https://www.linkedin.com/in/sam-seller"
      },
      "linkedInAccountId": 113298,
      "messages": [
        {
          "body": "Hi Jane, loved your webinar.",
          "createdAt": "2026-10-02T09:00:00Z",
          "isInMail": false,
          "postLink": "",
          "sender": "ME",
          "subject": ""
        },
        {
          "body": "Thanks, happy to chat next week.",
          "createdAt": "2026-10-03T12:00:19Z",
          "isInMail": false,
          "postLink": "",
          "sender": "CORRESPONDENT",
          "subject": ""
        }
      ],
      "read": false,
      "totalMessages": 2
    }
  ],
  "count": 1,
  "has_more": false,
  "next_offset": 1,
  "total_count": 1
}
```

### List leads in list

List the leads in a lead list, optionally only those added in a time range or matching a name. Gets one page of up to 1,000; to see more, run it again with the next offset.

**Inputs**

- List (`list_id`, text, required): The lead list. Pick one, or give its id from an earlier step.
- Name contains (`keyword`, text): Only those whose name contains this text.
- Lead's LinkedIn profile (`lead_profile_url`, text): Only this lead.
- Added from (`created_from`, date and time): Only leads added at or after this time.
- Added until (`created_to`, date and time): Only leads added at or before this time.
- Skip (`offset`, number): How many to skip, for the next page: give the 'next_offset' an earlier run returned. Defaults to 0. At least 0.
- Page size (`limit`, number): How many to return, 1 to 1000. Defaults to 1000. From 1 to 1000.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is another page
- `leads` (list): The list's leads
- `list_id` (number): The list
- `next_offset` (number): The offset to give for the next page
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "leads": [
    {
      "about": "",
      "companyName": "Acme",
      "companyUrl": "https://www.linkedin.com/company/acme",
      "connections": 500,
      "customFields": [
        {
          "name": "favorite_color",
          "value": "blue"
        }
      ],
      "emailAddress": "jane@example.com",
      "firstName": "Jane",
      "followers": 820,
      "headline": "Head of Marketing at Acme",
      "imageUrl": "https://media.licdn.com/dms/image/jane.jpg",
      "lastName": "Doe",
      "linkedin_id": "58344979",
      "location": "Austin, Texas",
      "position": "Head of Marketing",
      "profileUrl": "https://www.linkedin.com/in/jane-doe",
      "tags": [
        "webinar"
      ]
    }
  ],
  "list_id": 3457,
  "next_offset": 1,
  "total_count": 1
}
```

### List LinkedIn senders

List the LinkedIn accounts connected to HeyReach as senders, with whether each is signed in, its active campaigns and its daily limits.

**Inputs**

- Name contains (`keyword`, text): Only those whose name contains this text.
- Skip (`offset`, number): How many to skip, for the next page: give the 'next_offset' an earlier run returned. Defaults to 0. At least 0.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 100. From 1 to 100.

**Outputs**

- `accounts` (list): The LinkedIn senders
- `count` (number): How many on this page
- `has_more` (true/false): Whether there is another page
- `next_offset` (number): The offset to give for the next page
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "accounts": [
    {
      "accountLimits": {
        "connectioRequestLimit": 20,
        "connectioRequestMax": 50,
        "inMailLimit": 0,
        "inMailLimitMax": 50,
        "messageLimit": 50,
        "messageLimitMax": 150,
        "profileViewLimit": 80,
        "profileViewLimitMax": 150
      },
      "activeCampaigns": 2,
      "authIsValid": true,
      "emailAddress": "sam@example.com",
      "firstName": "Sam",
      "id": 113298,
      "isActive": true,
      "isValidNavigator": false,
      "isValidRecruiter": false,
      "lastName": "Seller",
      "profileUrl": "https://www.linkedin.com/in/sam-seller"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_offset": 1,
  "total_count": 1
}
```

### List lists

List lead and company lists with their sizes and campaigns. Gets one page; to see more, run it again with the next offset.

**Inputs**

- Name contains (`keyword`, text): Only those whose name contains this text.
- Type (`list_type`, text): Only lead lists or only company lists. One of: `USER_LIST` (Lead list), `COMPANY_LIST` (Company list).
- Skip (`offset`, number): How many to skip, for the next page: give the 'next_offset' an earlier run returned. Defaults to 0. At least 0.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 100. From 1 to 100.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there is another page
- `lists` (list): The lists
- `next_offset` (number): The offset to give for the next page
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "lists": [
    {
      "campaignIds": [
        274079
      ],
      "creationTime": "2026-09-30T09:34:56Z",
      "id": 3457,
      "listType": "USER_LIST",
      "name": "Webinar leads",
      "totalItemsCount": 120
    }
  ],
  "next_offset": 1,
  "total_count": 1
}
```

### Pause campaign

Pause a running campaign, so it stops reaching out.

**Inputs**

- Campaign (`campaign_id`, text, required): The campaign. Pick one, or give its id from an earlier step.

**Outputs**

- `campaign_id` (number): The campaign paused
- `paused` (true/false): Always true once paused

**Example output**

```json
{
  "campaign_id": 274079,
  "paused": true
}
```

### Remove lead from list

Remove a lead from a lead list by their LinkedIn profile.

**Inputs**

- List (`list_id`, text, required): The lead list. Pick one, or give its id from an earlier step.
- LinkedIn profile (`profile_url`, text, required): The lead's LinkedIn profile address.

**Outputs**

- `list_id` (number): The list
- `not_found` (list): Profile names HeyReach did not find in the list
- `profile_url` (text): The lead's profile
- `removed` (true/false): False if the lead was not in the list

**Example output**

```json
{
  "list_id": 3457,
  "not_found": [],
  "profile_url": "https://www.linkedin.com/in/jane-doe",
  "removed": true
}
```

### Resume campaign

Resume a paused campaign. It starts sending LinkedIn invitations and messages to its leads again.

**Inputs**

- Campaign (`campaign_id`, text, required): The campaign. Pick one, or give its id from an earlier step.

**Outputs**

- `campaign_id` (number): The campaign resumed
- `resumed` (true/false): Always true once resumed

**Example output**

```json
{
  "campaign_id": 274079,
  "resumed": true
}
```

### Send message

Send a LinkedIn message into a conversation from its sender's LinkedIn account. The lead receives it at once.

**Inputs**

- LinkedIn sender (`linkedin_account_id`, text, required): The LinkedIn account in HeyReach the conversation belongs to. Pick one, or give its id from 'List conversations'.
- Conversation ID (`conversation_id`, text, required): The conversation's id, from 'List conversations' or a trigger.
- Message (`message`, text, required): The text to send.
- Subject (`subject`, text): A subject, used only for InMail conversations.

**Outputs**

- `conversation_id` (text): The conversation
- `linkedin_account_id` (number): The sender
- `sent` (true/false): Always true once sent

**Example output**

```json
{
  "conversation_id": "2-ODM0YmIzNzgtOGEyOS00ZTYz",
  "linkedin_account_id": 113298,
  "sent": true
}
```

### Stop lead in campaign

Stop a campaign reaching out to one lead, such as someone who booked a call. Give their LinkedIn profile or LinkedIn id.

**Inputs**

- Campaign (`campaign_id`, text, required): The campaign. Pick one, or give its id from an earlier step.
- LinkedIn profile (`profile_url`, text): The lead's LinkedIn profile address.
- Lead's LinkedIn id (`lead_linkedin_id`, text): Instead of the profile: the lead's linkedin_id from 'List campaign leads' or 'Get lead'.

**Outputs**

- `campaign_id` (number): The campaign
- `lead_linkedin_id` (text): The lead's id
- `profile_url` (text): The lead's profile
- `stopped` (true/false): Always true once stopped

**Example output**

```json
{
  "campaign_id": 274079,
  "lead_linkedin_id": "",
  "profile_url": "https://www.linkedin.com/in/jane-doe",
  "stopped": true
}
```

### Tag lead

Add tags to a lead, keeping the tags they already have, such as 'interested' after a reply.

**Inputs**

- LinkedIn profile (`profile_url`, text, required): The lead's LinkedIn profile address.
- Tags (`tags`, list, required): The tags to add.
- Create new tags (`create_missing_tags`, text): Create any tag HeyReach doesn't have yet. If no, a new tag makes the step fail. Defaults to yes. One of: `true` (Yes), `false` (No).

**Outputs**

- `new_tags` (list): Tags the lead did not have before
- `profile_url` (text): The lead's profile
- `tags` (list): Tags given

**Example output**

```json
{
  "new_tags": [
    "interested"
  ],
  "profile_url": "https://www.linkedin.com/in/jane-doe",
  "tags": [
    "interested"
  ]
}
```
