Tags API calls

Get tags

GET /tags

Returns all tags used in the workspace. Each tag is associated with the number of contacts tagged with it.

Response

{
	"tags":{
		"clients":"123",
		"friends":"89",
		...
	}
}

Get contact tags

GET /contacts/#{contact_id}/tags

Returns all tags used for the contact.

Response

{
	"tags":{
		"clients":"clients",
		"friends":"friends",
		...
	}
}

Create tag

POST /contacts/#{contact_id}/tags

Adds a tag to a person or a company.

Request

{
	"tags":"clients,friends"
}

Response

Returns HTTP status code 201 (“Created”) on success. On failure, a non-200 status code will be returned, possibly with error information in JSON format as the response's content.

Destroy tag

DELETE /contacts/#{contact_id}/tags/#{tag}

Removes a tag from a person or a company.

Response

Returns HTTP status code 200 on success, or any other code (and possibly error information in JSON format) on error.