Skip to content

Area: Developers

POST

Report a tap on a message

Path
/inbox/messages/{messageId}/action
Auth
Access token · browser or app
POST
/inbox/messages/{messageId}/action
curl --request POST \
--url https://releva.ai/api/v0/inbox/messages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/action \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "userId": "DEMO-CUSTOMER-1001", "devicePlatform": "ios" }'

Records an inboxMessageClick event (shown as Inbox clicks in the push notification statistics) when the shopper taps a link or button in the message. Does not mark the message as read. Every call counts as one click.

messageId
required
string format: uuid

The message id from the list response (a delivery id, not inboxMessageId).

Media typeapplication/json
object
userId
required
string
>= 1 characters <= 96 characters
devicePlatform

Sent by the SDKs. Accepted but currently not stored.

string

Example

{
"userId": "DEMO-CUSTOMER-1001",
"devicePlatform": "ios"
}

Accepted for asynchronous processing.

Media typeapplication/json
object
0

Example

{}

Authentication error, or userId missing or longer than 96 characters.

Media typeapplication/json
object
message
required

Human-readable error. Several validation errors are joined with a space.

string

Examples

{
"message": "Authorization header is missing",
"and accessToken url parameters is also missing. At least one of them is required.": null
}

The domain is disabled.

Media typeapplication/json
object
message
required

Human-readable error. Several validation errors are joined with a space.

string

Example

{
"message": "Domain is disabled. Please reach out to support@releva.ai to enable it."
}

No message with this id for this userId in this shop.

Media typeapplication/json
object
message
required

Human-readable error. Several validation errors are joined with a space.

string

Example

{
"message": "Message not found."
}

Unexpected error. Currently also returned for malformed input: a messageId that is not a UUID, a userId that is not a string, userId only in the query string of a POST or DELETE, or a negative limit.

Media typeapplication/json
object
message
required

Human-readable error. Several validation errors are joined with a space.

string

Example

{
"message": "An internal error occurred."
}