Skip to main content
The email sends endpoints read the sends in Email: which survey went out, to whom, when, and what happened to each message. These endpoints only read, so sending, scheduling, canceling and test emails stay in Usertick. Because the recipient list holds addresses, it also requires contacts:read. An app or an AI assistant acts as the person who connected it and, with the View surveys and results permission, reads the sends of the surveys that person’s role reaches. An API key reads every send of the organization.

List sends

GET /email/sends takes a view:
  • past (the default) lists every send that isn’t waiting for a later time, newest first.
  • scheduled lists the sends that wait for their time, soonest first.
  • attention lists the sends that failed or stopped in the last 30 days.
surveyId keeps one survey’s sends, and search matches part of the subject, the survey’s name or a list’s name, up to 200 characters. sort takes when, survey, recipients or answered, with :asc or :desc, such as recipients:desc. Because scheduled sends haven’t gone out, the scheduled view doesn’t offer answered as a sort.
audience.contactIds is null in the list. GET /email/sends/{sendId} fills it with the hand-picked people who are still contacts, by ID only, and GET /contacts/{contactId} reads their addresses with contacts:read.

Read who a send reached

GET /email/sends/{sendId}/recipients lists each recipient, oldest first:
  • status is sent, failed, bounced, complained, or a skipped reason: skipped_unsubscribed, skipped_dedup (the person had this survey before), skipped_suppressed, skipped_quota, skipped_paused or skipped_survey_closed.
  • The status filter takes all, sent, failed, bounced, complained or skipped, which keeps every skipped reason.
  • search matches part of the address, and sort takes time, email or status, with :asc or :desc.
  • email is null once the contact was deleted or erased, because Usertick blanks the address in the send history and keeps the row so the send’s counts stay.
GET /email/sends/{sendId}/recipients/summary counts every recipient of the send by status, without addresses, and groups the failed ones by error text. It returns the 50 most common texts, with failureReasonTotal giving how many different texts there are.

Errors

A send that isn’t your organization’s, or whose survey your role doesn’t reach, returns 404 with PUB-014-001. A surveyId that isn’t one of your surveys returns 404 with APK-006-005. A sort, a view or a filter value the list doesn’t take returns 400 with PUB-001-004 for that parameter. See Errors.
Last modified on November 15, 2026