Tags
Everything about tags
Operations
| Method | Endpoint | Description |
|---|---|---|
POST | /articles/{article_id}/tags | Add a tag to an article |
DELETE | /articles/{article_id}/tags/{id} | Remove a tag from an article |
POST | /internal_articles/{internal_article_id}/tags | Add a tag to an internal article |
DELETE | /internal_articles/{internal_article_id}/tags/{id} | Remove a tag from an internal article |
GET | /contacts/{contact_id}/tags | List tags attached to a contact |
POST | /contacts/{contact_id}/tags | Add tag to a contact |
DELETE | /contacts/{contact_id}/tags/{tag_id} | Remove tag from a contact |
POST | /content_snippets/{content_snippet_id}/tags | Add a tag to a content snippet |
DELETE | /content_snippets/{content_snippet_id}/tags/{id} | Remove a tag from a content snippet |
POST | /conversations/{conversation_id}/tags | Add tag to a conversation |
DELETE | /conversations/{conversation_id}/tags/{tag_id} | Remove tag from a conversation |
GET | /tags | List all tags |
POST | /tags | Create or update a tag, Tag or untag companies, Tag contacts |
GET | /tags/{tag_id} | Find a specific tag |
DELETE | /tags/{tag_id} | Delete tag |
POST | /tickets/{ticket_id}/tags | Add tag to a ticket |
DELETE | /tickets/{ticket_id}/tags/{tag_id} | Remove tag from a ticket |
Example
List tags attached to a contact, with the TypeScript SDK:
ts
import { Intercom } from "@octridev/intercom";
const client = new Intercom({
// Optional: replaces the default server and any server an operation declares.
baseUrl: "https://api.intercom.io",
auth: { bearerAuth: process.env.API_TOKEN! },
});
const result = await client.contacts.listTags({
contactId: "contact-1",
});
console.log(result);Nine more languages
The same call exists in every SDK. See SDKs for the other nine.