Skip to content

Messages

Open .md

API reference Messages and activity

Your team's whole message inbox: emails and texts exchanged with customers and vendors on all sales orders, quotes and purchase orders, with their delivery status. Read them, retry failed deliveries and set a message status here. To send a message on one order, use Sales order messages.

8 operations

  • GETList messages/v2/api/store/{team_slug}/messagesLists the messages on your team's sales orders, quotes and purchase orders, newest first: emails and texts you sent to customers and vendors, and the replies they sent back.
  • GETList a message's recipients/v2/api/store/{team_slug}/messages/{hash_id}/recipientsLists everyone a message was sent to, with how delivery went for each: the address or number it went to at the time, the channel (email or sms), the status, and the provider's error when it failed.
  • POSTFilter messages/v2/api/store/{team_slug}/messages/filterLists messages like GET /v2/api/store/{team_slug}/messages, narrowed by direction or status, with an optional sort.
  • GETGet a message/v2/api/store/{team_slug}/messages/{hash_id}Returns one message in full: the message as written (message), the whole message as HTML (original_message), attachments, recipients with their delivery status, its team status, and retryable, which says whether a failed delivery can…
  • GETGet one recipient of a message/v2/api/store/{team_slug}/messages/{hash_id}/recipients/{id}Returns one recipient's delivery: where it was sent, the channel, the status and any provider error.
  • PUTRetry delivery to one recipient/v2/api/store/{team_slug}/messages/{hash_id}/recipients/{id}/retrySends the message again to one recipient whose delivery failed.
  • PUTRetry a message's failed deliveriesSpends money/v2/api/store/{team_slug}/messages/{hash_id}/retrySends an outbound message again to the recipients it failed to reach.
  • PUTSet a message's status/v2/api/store/{team_slug}/messages/{hash_id}/statusSets your team's own status on a message, such as "Need to Respond" or "Completed", for sorting your inbox.