Skip to Content
SendlySendly
API ReferenceProjects

Create a project

POST
/api/users/me/projects

Create a new project owned by the authenticated user. Answers the raw project row directly — no { success, data } envelope — with status 201.

Preconditions the route enforces before writing: the caller's email must be verified, the caller must be under their cap on active (non-disabled) owned projects, and the call is rate-limited per user.

Requires the projects:write scope — Create, change, reset and delete projects on your account.

cookiebetter-auth.session_token<token>

BetterAuth session cookie. Used by the dashboard / browser clients. When present, the active project is taken from the x-project-id header.

application/json
  1. body
name*string
Length1 <= length <= 100
sesRegion?string

AWS SES region for the project. Once a domain is added the region is locked and cannot be changed.

Value in"us-east-1""us-west-2""eu-west-1"

Response Body

Project created

application/json
  1. response
id*string
Formatuuid
name*string
disabled*boolean
disabledReason*string|null
sandboxHandle*|

Local-part of the sandbox quick-start sender; null until first derived.

stripeCustomerId*string|null
stripeSubscriptionId*string|null
billingLimitWorkflows*integer|null
billingLimitCampaigns*integer|null
billingLimitTransactional*integer|null
billingLimitInbound*integer|null
tracking*string
Value in"ENABLED""DISABLED""MARKETING_ONLY"
sesRegion*string|null
language*string

ISO 639-1 code for customer-facing content.

organizationId*string|null
createdAt*string

ISO 8601 datetime string

Formatdate-time
updatedAt*string

ISO 8601 datetime string

Formatdate-time
Example Request
curl -X POST 'https://api.sendly.now/api/users/me/projects' \  -H 'Content-Type: application/json' \  -d '{  "name": "string"}'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "disabled": true,  "disabledReason": "string",  "sandboxHandle": "string",  "stripeCustomerId": "string",  "stripeSubscriptionId": "string",  "billingLimitWorkflows": 0,  "billingLimitCampaigns": 0,  "billingLimitTransactional": 0,  "billingLimitInbound": 0,  "tracking": "ENABLED",  "sesRegion": "string",  "language": "string",  "organizationId": "string",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}