Supported tags attributes:

AttributeTypeDescription
idnumberUnique identifier of the tag.
namestringName of the tag.
resource_typestringType name of the resource the tag can be attached to. Possible values: lead, contact, prospect\_and\_customer, deal

Endpoints

Stream Tags

Read the stream of tag events.

See the Firehose Overview article for more details on request and response formats and parameters.

Action

GET /v3/tags/stream

Examples

Read the stream of tag events

GET /v3/tags/stream?position=tailAccept: application/jsonAuthorization: Bearer $ACCESS_TOKENUser-Agent: $CLIENT_NAME
HTTP/1.1 200 OK   Content-Type: application/json
{ "items": [    {        "data": {            "id": 527366,            "name": "abc",            "resource_type": "deal"        },        "meta": {            "event_id": "o4vLQU2KTaKbK2df8gWzRA",            "event_time": "2016-08-22T15:14:23Z",            "event_cause": "interaction",            "event_type": "created",            "sequence": 1,            "type": "tag"        }    }  ],  "meta": {    "links": {      "next": "https://api.getbase.com/v3/tags/stream?position=ZmlyZWhvc2UuZmFjdG9pZC5jb250YWN0LnNuYXBzaG90cywxLDMwNTQ5Mg=="    },    "position": "ZmlyZWhvc2UuZmFjdG9pZC5jb250YWN0LnNuYXBzaG90cywxLDMwNTQ5Mg==",    "top": false  }}