Mail API reference

Mail API · Sending-Defaults

get/v1/workspaces/{workspace_id}/sending-defaultsAuth

Get the workspace default sender

The From used by template sends that name none, with the live verification status of its domain. `default_sender` is null when none is set.

Path parameters

workspace_id*string · uuid

Id of the workspace.

Response · 200

default_sender*object

The workspace default sender, or null when none is set. With none set, a template send with no `from` is skipped: the HTTP route answers 422 `no_default_sender`, and an `email.skipped` webhook event is logged.

skipped_sends*object

Sends skipped for want of a sender (`no_default_sender`). A non-zero `count` means some product emails did not go out: set a default sender.

updated_at*string · date-time

When the settings last changed (set, cleared, or first created by a skipped send); null when there are none.

Example: "2026-10-17T09:30:00.000Z"

Example

Request

GET https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/sending-defaults
Authorization: Bearer YOUR_TOKEN

Response

{
  "default_sender": {},
  "skipped_sends": {},
  "updated_at": "2026-10-17T09:30:00.000Z"
}