Skip to main content
POST
/
v1
/
sends
/
send
cURL
curl --request POST \
  --url https://api.notocat.com/v1/v1/sends/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "workspace_id": "<string>",
  "page_id": "<string>",
  "subject": "<string>",
  "preheader": "<string>",
  "segment_id": "<string>",
  "font": "<string>",
  "css": "<string>",
  "linkColor": "#0000ED",
  "dividerColor": "#434343",
  "dividerSize": 1,
  "showCover": true,
  "trackOpens": true,
  "trackLinks": true,
  "senderId": "<string>",
  "properties": {}
}'
{
  "subscribers": 123,
  "status": "sending"
}
This endpoint can be used to create and send an issue in one request.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Send creation and configuration data

​
workspace_id
string
required

The ID of the workspace (newsletter)

​
page_id
string
required

The ID of the Notion page to transform into an issue

​
subject
string

The subject line of the email. If not provided, it will be extracted from the Notion page properties.

​
preheader
string

The preheader text of the email

​
segment_id
string

The ID of the segment to send to. If not provided, all workspace contacts will be used.

​
font
string

The font used in the email

​
css
string

Custom CSS for the email

​
linkColor
string
default:#0000ED

The color of links in the email

​
dividerColor
string
default:#434343

The color of dividers in the email

​
dividerSize
integer
default:1

The size of dividers in the email

​
showCover
boolean
default:true

Whether to show the cover image in the email

​
trackOpens
boolean
default:true

Whether to track email opens

​
trackLinks
boolean
default:true

Whether to track link clicks

​
senderId
string

The ID of the sender to use for this send. Find sender IDs in your email settings on Notocat.

​
properties
object

Notion page properties object, used to extract subject if not explicitly provided

Response

Issue created and sent successfully

​
subscribers
integer

The number of subscribers the issue was sent to

​
status
enum<string>

The status of the send operation

Available options:
sending