# ClickFunnels

> Work with your ClickFunnels 2.0 account: find, create, update and remove contacts, tag them and add notes, read orders, products, funnels, form submissions and courses, and manage webhook endpoints.

App · 27 actions. Web page: https://docs.lodol.com/docs/integrations/clickfunnels

## Actions

### Add contact note

Add a note to a contact's activity.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or an earlier step.
- Note (`content`, text, required): The text of the note.
- When it happened (`occurred_at`, date and time): When the noted event happened. Defaults to now.

**Outputs**

- `note` (object): The new note

**Example output**

```json
{
  "note": {
    "contact_id": 24359,
    "content": "Called about the refund.",
    "created_at": "2026-10-12T14:03:00.000Z",
    "created_by_id": 9,
    "id": 301,
    "occurred_at": "2026-10-12T14:03:00.000Z",
    "public_id": "nTe123",
    "updated_at": "2026-10-12T14:03:00.000Z"
  }
}
```

### Add tag to contact

Put a tag on a contact. The result holds the applied-tag id that 'Remove tag from contact' needs.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or an earlier step.
- Tag (`tag_id`, text, required): The contact tag. Pick one, or give its id from an earlier step.

**Outputs**

- `applied_tag` (object): The tag on the contact

**Example output**

```json
{
  "applied_tag": {
    "contact": null,
    "contact_id": 24359,
    "created_at": "2026-10-15T09:00:00.000Z",
    "id": 5,
    "public_id": "jgqvTJ",
    "tag": {
      "color": "#00FF00",
      "id": 60,
      "name": "Newsletter",
      "public_id": "rnZVJU"
    },
    "tag_id": 60,
    "updated_at": "2026-10-15T09:00:00.000Z"
  }
}
```

### Create contact

Add a contact to a workspace. Fails if the workspace already has a contact with that email address; use 'Create or update contact' to cover both.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Email address (`email_address`, text, required): The contact's email address.
- First name (`first_name`, text): The contact's first name.
- Last name (`last_name`, text): The contact's last name.
- Phone number (`phone_number`, text): The contact's phone number.
- Time zone (`time_zone`, text): ClickFunnels' name for the time zone, such as Pacific Time (US & Canada).
- Website (`website_url`, text): The contact's website address.
- Custom attributes (`custom_attributes`, object): Your own fields on the contact, as names and values. A name that is new creates the field; one that exists changes it.
- Tags (`tag_ids`, list): Put these tags on the new contact.

**Outputs**

- `contact` (object): The new contact

**Example output**

```json
{
  "contact": {
    "created_at": "2026-10-15T09:00:00.000Z",
    "custom_attributes": {
      "company": "Acme"
    },
    "deleted_at": null,
    "email_address": "jo@example.com",
    "fb_url": null,
    "first_name": "Jo",
    "id": 24359,
    "instagram_url": null,
    "is_active": true,
    "last_name": "Bloggs",
    "linkedin_url": null,
    "phone_number": "+15555550100",
    "public_id": "vQxYMj",
    "tags": [],
    "time_zone": "Pacific Time (US & Canada)",
    "twitter_url": null,
    "unsubscribed_at": null,
    "updated_at": "2026-10-15T09:00:00.000Z",
    "website_url": null,
    "workspace_id": 4
  }
}
```

### Create contact tag

Add a contact tag to a workspace.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Name (`name`, text, required): The tag's name.
- Color (`color`, text): A hex colour such as #2E7D32.

**Outputs**

- `tag` (object): The new tag

**Example output**

```json
{
  "tag": {
    "color": "#00FF00",
    "created_at": "2026-10-15T09:00:00.000Z",
    "id": 60,
    "name": "Newsletter",
    "public_id": "rnZVJU",
    "updated_at": "2026-10-15T09:00:00.000Z",
    "workspace_id": 4
  }
}
```

### Create or update contact

Create the contact with this email address, or update them if they already exist. Fields left empty are not changed.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Email address (`email_address`, text, required): The contact's email address.
- First name (`first_name`, text): The contact's first name. Leave empty to keep it.
- Last name (`last_name`, text): The contact's last name. Leave empty to keep it.
- Phone number (`phone_number`, text): The contact's phone number. Leave empty to keep it.
- Time zone (`time_zone`, text): ClickFunnels' name for the time zone, such as Pacific Time (US & Canada). Leave empty to keep it.
- Website (`website_url`, text): The contact's website address. Leave empty to keep it.
- Custom attributes (`custom_attributes`, object): Your own fields on the contact, as names and values. A name that is new creates the field; one that exists changes it.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "created_at": "2026-10-15T09:00:00.000Z",
    "custom_attributes": {
      "company": "Acme"
    },
    "deleted_at": null,
    "email_address": "jo@example.com",
    "fb_url": null,
    "first_name": "Jo",
    "id": 24359,
    "instagram_url": null,
    "is_active": true,
    "last_name": "Bloggs",
    "linkedin_url": null,
    "phone_number": "+15555550100",
    "public_id": "vQxYMj",
    "tags": [],
    "time_zone": "Pacific Time (US & Canada)",
    "twitter_url": null,
    "unsubscribed_at": null,
    "updated_at": "2026-10-15T09:00:00.000Z",
    "website_url": null,
    "workspace_id": 4
  }
}
```

### Create webhook endpoint

Have ClickFunnels send the chosen events (contact created, order completed and so on) to an https address.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Name (`name`, text, required): A name for the endpoint, shown in ClickFunnels.
- Address (`url`, text, required): The https:// address to send notifications to.
- Events (`event_type_ids`, list, required): The events to send.

**Outputs**

- `endpoint` (object): The new endpoint

**Example output**

```json
{
  "endpoint": {
    "api_version": 2,
    "created_at": null,
    "event_type_ids": [
      "contact.created",
      "order.completed"
    ],
    "id": 12,
    "name": "Lodol",
    "public_id": "wHk789",
    "updated_at": null,
    "url": "https://example.com/hooks/clickfunnels",
    "webhook_secret_last_four": "a1b2",
    "workspace_id": 4
  }
}
```

### Delete contact

Remove a contact from lists and filters. ClickFunnels keeps the record readable by id, marked deleted. Refused for a contact with an active subscription or course enrolments.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or an earlier step.

**Outputs**

- `contact_id` (text): The id of the contact deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "contact_id": "24359",
  "deleted": true
}
```

### Delete contact note

Permanently delete a note from a contact's activity.

**Inputs**

- Note ID (`note_id`, text, required): The note's id, from 'List contact notes' or 'Add contact note'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `note_id` (text): The id of the note deleted

**Example output**

```json
{
  "deleted": true,
  "note_id": "301"
}
```

### Delete contact tag

Delete a contact tag. Contacts that had it lose it.

**Inputs**

- Tag (`tag_id`, text, required): The contact tag. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `tag_id` (text): The id of the tag deleted

**Example output**

```json
{
  "deleted": true,
  "tag_id": "60"
}
```

### Delete webhook endpoint

Delete a webhook endpoint so ClickFunnels stops sending to it.

**Inputs**

- Webhook endpoint (`endpoint_id`, text, required): The endpoint. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `endpoint_id` (text): The id of the webhook endpoint deleted

**Example output**

```json
{
  "deleted": true,
  "endpoint_id": "12"
}
```

### Get contact

Get one contact with their tags and custom attributes.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or an earlier step.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "created_at": "2026-10-15T09:00:00.000Z",
    "custom_attributes": {
      "company": "Acme"
    },
    "deleted_at": null,
    "email_address": "jo@example.com",
    "fb_url": null,
    "first_name": "Jo",
    "id": 24359,
    "instagram_url": null,
    "is_active": true,
    "last_name": "Bloggs",
    "linkedin_url": null,
    "phone_number": "+15555550100",
    "public_id": "vQxYMj",
    "tags": [],
    "time_zone": "Pacific Time (US & Canada)",
    "twitter_url": null,
    "unsubscribed_at": null,
    "updated_at": "2026-10-15T09:00:00.000Z",
    "website_url": null,
    "workspace_id": 4
  }
}
```

### Get current user

Get the ClickFunnels user the access token belongs to.

**Inputs**: None.

**Outputs**

- `user` (object): The connected user

**Example output**

```json
{
  "user": {
    "created_at": null,
    "email": "jo@example.com",
    "first_name": "Jo",
    "id": 9,
    "last_name": "Bloggs",
    "locale": "en",
    "public_id": "uSr001",
    "time_zone": "Pacific Time (US & Canada)",
    "updated_at": null
  }
}
```

### List contact notes

List the notes in a contact's activity.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or an earlier step.
- Order (`direction`, text): Sort order. Defaults to oldest first. One of: `asc` (Oldest first (default)), `desc` (Newest first).
- Page size (`limit`, number): How many to return, 1 to 100. ClickFunnels' default is 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `next_cursor` (text): Pass as 'after' for the next page; empty on the last one
- `notes` (list): The notes

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "notes": [
    {
      "contact_id": 24359,
      "content": "Called about the refund.",
      "created_at": "2026-10-12T14:03:00.000Z",
      "created_by_id": 9,
      "id": 301,
      "occurred_at": "2026-10-12T14:03:00.000Z",
      "public_id": "nTe123",
      "updated_at": "2026-10-12T14:03:00.000Z"
    }
  ]
}
```

### List contact tags

List the contact tags in a workspace, optionally by name.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Name (`name`, text): Only tags with this name.
- Page size (`limit`, number): How many to return, 1 to 100. ClickFunnels' default is 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `next_cursor` (text): Pass as 'after' for the next page; empty on the last one
- `tags` (list): The tags

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "tags": [
    {
      "color": "#00FF00",
      "created_at": "2026-10-15T09:00:00.000Z",
      "id": 60,
      "name": "Newsletter",
      "public_id": "rnZVJU",
      "updated_at": "2026-10-15T09:00:00.000Z",
      "workspace_id": 4
    }
  ]
}
```

### List contacts

List contacts in a workspace, filtered by email address, tags or status. Gets one page; to see more, run it again with the next page cursor it gives.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Email address (`email_address`, text): Only contacts with this address. Several can be given, separated by commas.
- Tags (`tag_ids`, list): Only contacts that have these tags.
- Status (`active`, text): Whether to include active or inactive contacts. One of: `any` (Active and inactive (default)), `active` (Active only), `inactive` (Inactive only).
- Sort by (`sort_by`, text): What to sort by. Defaults to when created. One of: `id` (When created (default)), `updated_at` (When last changed).
- Order (`direction`, text): Sort order. Defaults to oldest first. One of: `asc` (Oldest first (default)), `desc` (Newest first).
- Page size (`limit`, number): How many to return, 1 to 100. ClickFunnels' default is 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `contacts` (list): The contacts
- `count` (number): How many on this page
- `next_cursor` (text): Pass as 'after' for the next page; empty on the last one

**Example output**

```json
{
  "contacts": [
    {
      "created_at": "2026-10-15T09:00:00.000Z",
      "custom_attributes": {
        "company": "Acme"
      },
      "deleted_at": null,
      "email_address": "jo@example.com",
      "fb_url": null,
      "first_name": "Jo",
      "id": 24359,
      "instagram_url": null,
      "is_active": true,
      "last_name": "Bloggs",
      "linkedin_url": null,
      "phone_number": "+15555550100",
      "public_id": "vQxYMj",
      "tags": [],
      "time_zone": "Pacific Time (US & Canada)",
      "twitter_url": null,
      "unsubscribed_at": null,
      "updated_at": "2026-10-15T09:00:00.000Z",
      "website_url": null,
      "workspace_id": 4
    }
  ],
  "count": 1,
  "next_cursor": ""
}
```

### List courses

List the courses in a workspace.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Page size (`limit`, number): How many to return, 1 to 100. ClickFunnels' default is 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `courses` (list): The courses
- `next_cursor` (text): Pass as 'after' for the next page; empty on the last one

**Example output**

```json
{
  "count": 1,
  "courses": [
    {
      "created_at": null,
      "current_path": null,
      "description": "A short course.",
      "id": 14,
      "public_id": "cRs001",
      "published_at": "2026-10-01T09:00:00.000Z",
      "title": "Getting started",
      "updated_at": null
    }
  ],
  "next_cursor": ""
}
```

### List form submissions

List the form submissions in a workspace, optionally only a contact's.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Contact ID (`contact_id`, text): Only this contact's submissions.
- Order (`direction`, text): Sort order. Defaults to oldest first. One of: `asc` (Oldest first (default)), `desc` (Newest first).
- Page size (`limit`, number): How many to return, 1 to 100. ClickFunnels' default is 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `next_cursor` (text): Pass as 'after' for the next page; empty on the last one
- `submissions` (list): The submissions

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "submissions": [
    {
      "contact_id": 24359,
      "created_at": null,
      "data": {
        "email": "jo@example.com"
      },
      "id": 501,
      "page_id": 62,
      "public_id": "sUb001",
      "updated_at": null,
      "workspace_id": 4
    }
  ]
}
```

### List funnels

List the funnels in a workspace.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Page size (`limit`, number): How many to return, 1 to 100. ClickFunnels' default is 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `funnels` (list): The funnels
- `next_cursor` (text): Pass as 'after' for the next page; empty on the last one

**Example output**

```json
{
  "count": 1,
  "funnels": [
    {
      "archived": false,
      "created_at": null,
      "current_path": "/webinar",
      "id": 31,
      "live_mode": true,
      "name": "Webinar funnel",
      "public_id": "fUn001",
      "tags": null,
      "updated_at": null,
      "workspace_id": 4
    }
  ],
  "next_cursor": ""
}
```

### List orders

List orders in a workspace, filtered by contact, type or live/test mode. Live orders only unless you choose otherwise.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Contact ID (`contact_id`, text): Only this contact's orders.
- Type (`order_type`, text): One-time orders or subscriptions. One of: `any` (All orders (default)), `one-time-order` (One-time orders), `subscription-order` (Subscriptions).
- Live or test (`live_mode`, text): Real orders or test orders. Defaults to live. One of: `live` (Live orders (default)), `test` (Test orders), `any` (Live and test orders).
- Order (`direction`, text): Sort order. Defaults to oldest first. One of: `asc` (Oldest first (default)), `desc` (Newest first).
- Page size (`limit`, number): How many to return, 1 to 100. ClickFunnels' default is 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `next_cursor` (text): Pass as 'after' for the next page; empty on the last one
- `orders` (list): The orders

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "orders": [
    {
      "billing_status": "paid",
      "contact": null,
      "contact_id": 24359,
      "created_at": "2026-10-15T09:00:00.000Z",
      "currency": "USD",
      "funnel_name": null,
      "id": 22642,
      "line_items": [],
      "live_mode": true,
      "order_number": "#2146",
      "order_type": "one-time-order",
      "page_name": null,
      "public_id": "JmRRyN",
      "service_status": "active",
      "tax_amount": null,
      "total_amount": "396.00",
      "updated_at": null,
      "workspace_id": 4
    }
  ]
}
```

### List products

List the products in a workspace. Archived ones are left out unless asked for.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Archived (`archived`, text): Whether to include archived products. One of: `active` (Not archived (default)), `archived`, `any` (Archived and not).
- Page size (`limit`, number): How many to return, 1 to 100. ClickFunnels' default is 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `next_cursor` (text): Pass as 'after' for the next page; empty on the last one
- `products` (list): The products

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "products": [
    {
      "archived": false,
      "created_at": "2026-10-01T09:00:00.000Z",
      "current_path": null,
      "default_variant_id": 88,
      "id": 77,
      "name": "Starter course",
      "price_ids": null,
      "public_id": "pRd456",
      "updated_at": null,
      "variant_ids": null,
      "visible_in_customer_center": null,
      "visible_in_store": true,
      "workspace_id": 4
    }
  ]
}
```

### List tags on contact

List the tags a contact has, with the id to remove each.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. ClickFunnels' default is 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `applied_tags` (list): The tags on the contact
- `count` (number): How many on this page
- `next_cursor` (text): Pass as 'after' for the next page; empty on the last one

**Example output**

```json
{
  "applied_tags": [
    {
      "contact": null,
      "contact_id": 24359,
      "created_at": "2026-10-15T09:00:00.000Z",
      "id": 5,
      "public_id": "jgqvTJ",
      "tag": {
        "color": "#00FF00",
        "id": 60,
        "name": "Newsletter",
        "public_id": "rnZVJU"
      },
      "tag_id": 60,
      "updated_at": "2026-10-15T09:00:00.000Z"
    }
  ],
  "count": 1,
  "next_cursor": ""
}
```

### List webhook endpoints

List the addresses ClickFunnels sends event notifications to.

**Inputs**

- Workspace (`workspace_id`, text): The workspace to use. Leave empty for the workspace at the subdomain you connected with.
- Page size (`limit`, number): How many to return, 1 to 100. ClickFunnels' default is 20. From 1 to 100.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `endpoints` (list): The endpoints
- `next_cursor` (text): Pass as 'after' for the next page; empty on the last one

**Example output**

```json
{
  "count": 1,
  "endpoints": [
    {
      "api_version": 2,
      "created_at": null,
      "event_type_ids": [
        "contact.created",
        "order.completed"
      ],
      "id": 12,
      "name": "Lodol",
      "public_id": "wHk789",
      "updated_at": null,
      "url": "https://example.com/hooks/clickfunnels",
      "webhook_secret_last_four": "a1b2",
      "workspace_id": 4
    }
  ],
  "next_cursor": ""
}
```

### List workspaces

List the workspaces of the teams the access token belongs to, with their subdomains.

**Inputs**: None.

**Outputs**

- `count` (number): How many
- `workspaces` (list): The workspaces

**Example output**

```json
{
  "count": 1,
  "workspaces": [
    {
      "created_at": null,
      "id": 4,
      "name": "Acme Sales",
      "public_id": "wSp001",
      "subdomain": "acme",
      "team_id": 2,
      "team_name": "Acme",
      "updated_at": null
    }
  ]
}
```

### Remove tag from contact

Take a tag off a contact, using the applied-tag id from 'Add tag to contact' or 'List tags on contact'.

**Inputs**

- Applied tag ID (`applied_tag_id`, text, required): The id of the tag on the contact (not the tag's own id).

**Outputs**

- `applied_tag_id` (text): The id of the applied tag deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "applied_tag_id": "5",
  "deleted": true
}
```

### Update contact

Change a contact's details. Only the fields given change; to change their tags use 'Add tag to contact' and 'Remove tag from contact'.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or an earlier step.
- Email address (`email_address`, text): A new email address. Leave empty to keep it.
- First name (`first_name`, text): The contact's first name. Leave empty to keep it.
- Last name (`last_name`, text): The contact's last name. Leave empty to keep it.
- Phone number (`phone_number`, text): The contact's phone number. Leave empty to keep it.
- Time zone (`time_zone`, text): ClickFunnels' name for the time zone, such as Pacific Time (US & Canada). Leave empty to keep it.
- Website (`website_url`, text): The contact's website address. Leave empty to keep it.
- Custom attributes (`custom_attributes`, object): Your own fields on the contact, as names and values. A name that is new creates the field; one that exists changes it.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "created_at": "2026-10-15T09:00:00.000Z",
    "custom_attributes": {
      "company": "Acme"
    },
    "deleted_at": null,
    "email_address": "jo@example.com",
    "fb_url": null,
    "first_name": "Joanne",
    "id": 24359,
    "instagram_url": null,
    "is_active": true,
    "last_name": "Bloggs",
    "linkedin_url": null,
    "phone_number": "+15555550100",
    "public_id": "vQxYMj",
    "tags": [],
    "time_zone": "Pacific Time (US & Canada)",
    "twitter_url": null,
    "unsubscribed_at": null,
    "updated_at": "2026-10-15T09:00:00.000Z",
    "website_url": null,
    "workspace_id": 4
  }
}
```

### Update contact note

Change a note's text or the time it happened.

**Inputs**

- Note ID (`note_id`, text, required): The note's id, from 'List contact notes' or 'Add contact note'.
- Note (`content`, text): The new text. Leave empty to keep it.
- When it happened (`occurred_at`, date and time): A new time. Leave empty to keep it.

**Outputs**

- `note` (object): The note

**Example output**

```json
{
  "note": {
    "contact_id": 24359,
    "content": "Called back.",
    "created_at": "2026-10-12T14:03:00.000Z",
    "created_by_id": 9,
    "id": 301,
    "occurred_at": "2026-10-12T14:03:00.000Z",
    "public_id": "nTe123",
    "updated_at": "2026-10-12T14:03:00.000Z"
  }
}
```

### Update contact tag

Rename a contact tag or change its colour.

**Inputs**

- Tag (`tag_id`, text, required): The contact tag. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Color (`color`, text): A new hex colour such as #2E7D32. Leave empty to keep it.

**Outputs**

- `tag` (object): The tag

**Example output**

```json
{
  "tag": {
    "color": "#00FF00",
    "created_at": "2026-10-15T09:00:00.000Z",
    "id": 60,
    "name": "Newsletter (old)",
    "public_id": "rnZVJU",
    "updated_at": "2026-10-15T09:00:00.000Z",
    "workspace_id": 4
  }
}
```
