v3

latestOpenAPI 3.1.1mit2026-07-3165481.5 MB
Tags
v1

Create Tag

Create a new tag with the provided attributes. This endpoint allows clients to define a new tag that can be assigned to companies. The response returns the full tag object, including its generated identifier and timestamps. Credit Note: Creating tags doe not consume credits.

:::info Requires the tags:write OAuth2 scope. :::

post/v1/tags

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

Request body

Response

Success

Example response

{
  "data": {
    "type": "tag",
    "id": "4b7e2c9f",
    "attributes": {
      "name": "Prospects",
      "created_at": "2024-12-10T15:57:25Z",
      "updated_at": "2024-11-24T11:50:00Z"
    },
    "relationships": {
      "created_by": {
        "id": "12345"
      }
    }
  },
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}