Skip to main content

Miscellaneous

Values used by several endpoints that aren't described on the endpoint pages themselves.

Contacts​

Gender​

A contact's gender is a string. It is not detected automatically. See the user model.

ValueMeaning
unknownNot known (the default).
maleMale.
femaleFemale.

Phone number format​

Phone numbers must be in the E.164 format, for example +48123456789. To store a phone number in another format, create a custom attribute for it.

Attribute types​

When you create an attribute, its value_type is one of:

ValueAttribute type
booleanTrue or false.
integerWhole number.
floatFloating-point number.
stringText.
dateDate.
datetimeDate and time.
fixedOne or more fixed choices.
jsonJSON.

Message source types​

Where a message was sent from. When you create a conversation or a message, send source as a number; without it, the message gets 3 (API). Messages in responses return it as a label.

ValueLabel in responses
1Chat
2Email
3API (the default)
4SMS
8Facebook
9Instagram
10ChatAI

Any other number returns 400 with "is not a valid choice".

Deals​

Deal statuses​

ValueStatus
0Abandoned
1In progress
2Won
3Lost
4Archived

Deal scopes​

The possible values of a deal's scope. The scope currently has no effect. See the deal model.

ValueScope
1Open
2Participants (the default)

Activity statuses​

ValueStatus
0Not planned
1Planned
2Recently finished
3Overdue

Product event types​

When you create a product event, its event_type is one of:

add to cart, purchase, liking, add to observation, order, reservation, return, view, click, detail, add, remove, checkout, checkout option, refund, promo click