Write

Tag a Contact

Applies a tag to a contact by name, creating the tag automatically if it does not already exist. A single call upserts the tag and links it to the contact, so you never need a separate create step. Accepts an optional hex color for new tags and returns the resulting tag_id and contact_id.

add_contact_tagPOST/api/v1/contacts/tags
crispy — bash

Example prompt: Tag the contact at linkedin.com/in/jane-smith as vip with the color #FF5733

{
  "tag_id": "tag_8f2a1c",
  "contact_id": "contact_5e7b22"
}
Permission scope
core
Access
Write
Category
Lead Management

What you can build

Label a high-value prospect as vip the moment your agent identifies them
Segment contacts on the fly without pre-creating every tag first
Apply a consistent color-coded label across a freshly imported lead list
Mark contacts by deal stage or interest as conversations progress

Parameters

Inputs accepted by add_contact_tag.

NameTypeDescription
lookupobjectStructured contact identifier. Resolver picks the highest-priority field per RESOLVER-09 (crispy_id > linkedin_provider_id > external_id > linkedin_url > email).
namestringTag name to apply.
colorstringHex color e.g. #FF5733

The complete LinkedIn API. Ready when you are.

Connect your first LinkedIn profile in under 5 minutes. Every tool, every seat, no feature gates. Safe limits, warm-up, and full permission control built in.