Docs
/
/

Shared mAPI reference

Complete reference documentation for the Shared resource.

Shared

#

Resources that are shared across the API.

PageInfo

#

The information about a paginated result.

Attributes

after
string

The cursor to fetch entries after. Will only be present if there are more entries to fetch.

before
string

The cursor to fetch entries before. Will only be present if there are more entries to fetch before the current page.

page_size
integer

The number of entries to fetch per-page.

MessageTypeBooleanField

#

A boolean field used in a message type.

Attributes

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the boolean field.

default
boolean

The default value of the boolean field.

description
string
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

boolean

MessageTypeButtonField

#

A button field used in a message type.

Attributes

A text field used in a message type.

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the text field.

default
string

The default value of the text field.

description
string
max_length
integer
min_length
integer
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

text
key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the button field.

description
string
placeholder
string
required
boolean

Whether the field is required.

A text field used in a message type.

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the text field.

default
string

The default value of the text field.

description
string
max_length
integer
min_length
integer
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

text
type
enum(string)

The type of the field.

button

MessageTypeImageField

#

An image field used in a message type.

Attributes

A text field used in a message type.

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the text field.

default
string

The default value of the text field.

description
string
max_length
integer
min_length
integer
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

text

A text field used in a message type.

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the text field.

default
string

The default value of the text field.

description
string
max_length
integer
min_length
integer
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

text
key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the image field.

description
string
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

image

A URL field used in a message type.

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the url field.

default
string

The default value of the URL field.

description
string
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

url

MessageTypeUrlField

#

A URL field used in a message type.

Attributes

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the url field.

default
string

The default value of the URL field.

description
string
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

url

MessageTypeJsonField

#

A JSON field used in a message type.

Attributes

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the json field.

default
object

The default value of the JSON field.

description
string
placeholder
string
required
boolean

Whether the field is required.

schema
object

A JSON schema used to validate the structure of the JSON provided. Must be a valid JSON schema.

type
enum(string)

The type of the field.

json

MessageTypeMarkdownField

#

A markdown field used in a message type.

Attributes

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the markdown field.

default
string

The default value of the markdown field.

description
string
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

markdown

MessageTypeMultiSelectField

#

A multi-select field used in a message type.

Attributes

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the multi_select field.

default
string[]

The default values for the multi-select field.

description
string
options
object[]

The available options for the multi-select field.

label
string

The display label for the option.

value
string
Required

The value for the option.

placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

multi_select

MessageTypeSelectField

#

A select field used in a message type.

Attributes

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the select field.

default
string

The default value for the select field.

description
string
options
object[]

The available options for the select field.

label
string

The display label for the option.

value
string
Required

The value for the option.

placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

select

MessageTypeTextField

#

A text field used in a message type.

Attributes

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the text field.

default
string

The default value of the text field.

description
string
max_length
integer
min_length
integer
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

text

MessageTypeTextareaField

#

A textarea field used in a message type.

Attributes

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the textarea field.

default
string

The default value of the textarea field.

description
string
max_length
integer
min_length
integer
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

textarea

MessageTypeColorField

#

A hex color field (#RGB or #RRGGBB) used in a message type or partial input schema.

Attributes

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the color field.

default
string

The default hex color value.

description
string
placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

color

MessageTypeNumberField

#

A numeric field used in a message type or partial input schema, with optional min/max bounds and a unit label for display.

Attributes

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the number field.

default
number

The default numeric value.

description
string
max
number

Optional inclusive maximum allowed value.

min
number

Optional inclusive minimum allowed value.

placeholder
string
required
boolean

Whether the field is required.

unit_label
string

Optional short label shown after the input (e.g. px, kg).

type
enum(string)

The type of the field.

number

MessageTypeListField

#

A list field used in a message type.

Attributes

key
string

The unique key of the field.

label
string

The label of the field.

settings
object

Settings for the list field.

default
array

The default value of the list field.

description
string
item_schema
object

A JSON schema used to validate the structure of each item in the list. Must be a valid JSON schema.

placeholder
string
required
boolean

Whether the field is required.

type
enum(string)

The type of the field.

list

RecipientReference

#

A recipient reference, used when referencing a recipient by either their ID (for a user), or by a reference for an object.

Attributes

RecipientReference
2 possible types

A recipient reference, used when referencing a recipient by either their ID (for a user), or by a reference for an object.

GoalAttachment

#

Attaches a goal to a workflow, guide, or broadcast for attribution tracking.

Attributes

attribution_window_days
integer

The number of days to attribute conversions after the notification is sent. Must be between 1 and 30. Defaults to 7.

goal_key
string

The key of the goal to attach.

New chat