Report a push open

POST/v1/members/me/push_opens

Records that the guest tapped a push, on the notification or one of its buttons. Call it on every tap, then route the guest. A repeat of the same open is recorded once.

Permissions: Member token.

Guide

Push and in-app messages

Request headers#

Idempotency-Keystring
Any string up to 255 characters; use a UUID v4. Kept 24 hours per key (or member) and endpoint. Same key and body replays the first response with Idempotent-Replayed: true.
Max Length 255

Request body#

message_idstring (uuid)Required
message_id from the push payload.
opened_atstring (date-time)Required
When the guest tapped, from the device clock.
buttonstring
primary or secondary when a button was tapped. Leave it out for a tap on the notification.
One of primary, secondary

Response fields#

Returns 204 with no body.

POST/v1/members/me/push_opens

1
2
3
4
5
6
7
8curl -X POST https://api.unplugdining.com/v1/members/me/push_opens \
  -H "Authorization: Bearer mt_4kQ9xV2mR7tB8nW3pL6yZ1cH5fJ0dS" \
  -H "Content-Type: application/json" \
  -d '{
    "message_id": "5b81d3e0-2c4f-4a96-8e17-d0f9a3b62c58",
    "opened_at": "2026-10-30T15:06:12Z",
    "button": "primary"
  }'

1
2
3
4
5
6
7
8
9
10
11
12
13const response = await fetch("https://api.unplugdining.com/v1/members/me/push_opens", {
  method: "POST",
  headers: {
    Authorization: "Bearer mt_4kQ9xV2mR7tB8nW3pL6yZ1cH5fJ0dS",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    message_id: "5b81d3e0-2c4f-4a96-8e17-d0f9a3b62c58",
    opened_at: "2026-10-30T15:06:12Z",
    button: "primary",
  }),
});
const data = await response.json();

1
2
3
4
5
6
7
8
9
10
11
12
13
14import requests

response = requests.post(
    "https://api.unplugdining.com/v1/members/me/push_opens",
    headers={
        "Authorization": "Bearer mt_4kQ9xV2mR7tB8nW3pL6yZ1cH5fJ0dS",
    },
    json={
        "message_id": "5b81d3e0-2c4f-4a96-8e17-d0f9a3b62c58",
        "opened_at": "2026-10-30T15:06:12Z",
        "button": "primary",
    },
)
data = response.json()

Response JSON204

1(no body)

Error descriptions#

400Bad request

missing_param

: message_id or opened_at is missing.

400Bad request

invalid_param

: button isn't primary or secondary.

404Not found

not_found

No such message for this member.

Any endpoint can also return the common errors.

400 Bad request

1
2
3
4
5
6
7{
  "type": "https://docs.unplugdining.com/reference/errors#missing_param",
  "title": "Bad request",
  "status": 400,
  "code": "missing_param",
  "detail": ": message_id or opened_at is missing."
}