Data Types

Primitive Data Types

Date and time format

All timestamps are represented in the ISO 8601 format and in GMT. Dates in contact data are returned in a structured format.

Etags

Contacts and tags have etags. Etags are a 56-character hex string that identify a particular resource version. Etags are ordered in descending order. For example the following etag:

fffffeac1d522cf09487ce6912a9efe2279e154f63db8d5adf5d97d8

identifies a resource version that was created after this one:

ffffffffffffffffffffffffffffffffffffffffffffffffffffffff

When updating or deleting resources, you need to provide etag of the local copy of the resource, so the API can perform a 3-way merge of data (if needed) or prevent deleting a resource if it has a newer etag.

Resource IDs

All resource ids are strings. Contact ids and tag ids are unique.

Client-generated contact and tag ids must be uuids, but the API can return contact ids that are not in that format.

Objects