tags

Tags label prospects, campaigns, and senders for segmentation and filtering. Every tag has an immutable tagType (Crm, Campaign, or Sender) — only Crm-type tags can be attached to prospects.

tagType is immutable after creation. Only Crm tags attach to prospects; Campaign and Sender tags are for their respective resource types.

Operations

Read

• tags/get — List tags with optional filtering
• tags/get_by_id — Get a tag by ID
• tags/prospects_by_id — List prospects with this tag
• tags/campaigns_by_id — List campaigns with this tag
• tags/senders_by_id — List senders with this tag

Create

• tags/post — Create a new tag

Update

• tags/patch_by_id — Update a tag's title or description

Delete

• tags/delete_by_id — Delete a tag

Tag shapes

Two shapes exist: the embedded tag ref on campaign/sender/prospect responses uses {id, name} (see schemas/tag-ref); the tag operations return the full shape {tagId, title, description, tagType, createdAt}. Use tagId (not the name) when attaching tags.