Agendize Client API

Notes


Resource representation

{ "id": {string}, "tag": {string}, "color": {string}, "numberOfContacts": {integer} }
Parameter name Value Description
id string Identifier of the tag.
tag string Text of the tag.
color string Color of the tag. Hexadecimal web color.
numberOfContacts integer Number of contact linked with the tag. Read-only.

Delete

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

DELETE https://api.agendize.com/contacts/tags/{tagId}

Parameters

Parameter name Value Description
Path parameters
tagId string Tag identifier.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns an empty response body.


Get

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

GET https://api.agendize.com/api/2.3/contacts/tags/{tagId}

Parameters

Parameter name Value Description
Path parameters
tagId string Tag identifier.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a Tag resource in the response body.


List

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

GET https://api.agendize.com/api/2.3/contacts/tags

Parameters

Parameter name Value Description
Required query parameters
apiKey string API Key
Optional query parameters
contactId string Identifier of the contact.
withContactCount boolean to retrieve nomber of contacts per tag.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{ items: [Tag Resource] }

Insert

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

POST https://api.agendize.com/api/2.3/contacts/tags

Request body

In the request body, supply a Tag Resource with the following properties:

Parameter name Value Description
Required Properties
tag string Text of the tag.
Optional Properties
color string Color of the tag. Hexadecimal web color.

Response

If successful, this method returns a Tag resource in the response body.


Update

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

PUT https://api.agendize.com/api/2.3/contact/tags/{tagId}

Parameters

Parameter name Value Description
Path parameters
tagId string Note identifier.

Request body

In the request body, supply a Tag resource with the following properties:

Parameter name Value Description
Optional Properties
tag string Text of the tag.
color string Color of the tag. Hexadecimal web color.

Response

If successful, this method returns a Tag resource in the response body.