Skip to main content
POST
/
projects
Create a project
curl --request POST \
  --url https://apix.spotzee.com/api/client/projects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Marketing",
  "locale": "en-AU",
  "timezone": "Australia/Sydney"
}
'
{
  "id": 42,
  "organization_id": 7,
  "name": "Acme Marketing",
  "locale": "en-AU",
  "timezone": "Australia/Sydney",
  "created_at": "2026-04-28T05:14:00.000Z",
  "updated_at": "2026-04-28T05:14:00.000Z",
  "description": "<string>",
  "website_url": "https://acme.example",
  "text_opt_out_message": "<string>",
  "text_help_message": "<string>",
  "link_wrap_email": true,
  "link_wrap_push": true,
  "track_opens_email": true,
  "deeplink_mirror_url": "https://links.acme.example",
  "role": "admin",
  "has_provider": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.spotzee.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Organisation-scoped admin API key (ok_…). Pass in the Authorization: Bearer <key> header. Used to manage projects and other organisation-level resources.

Body

application/json

Create a new project inside the calling key’s organisation. Caller must have at least admin role on the organisation.

​
name
string
required

Human-readable project name.

Minimum string length: 1
Example:

"Acme Marketing"

​
locale
string
required

Default BCP-47 locale used for content rendering and timestamp formatting.

Required string length: 1 - 255
Example:

"en-AU"

​
timezone
string
required

Default IANA timezone used for time-of-day scheduling.

Required string length: 1 - 50
Example:

"Australia/Sydney"

​
description
string | null

Optional free-text description of the project.

​
website_url
string | null

The project’s public website URL. Optional protocol; HTTP or HTTPS only.

Pattern: ^$|^(https?:\/\/)?([a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}(:[0-9]+)?(\/\S*)?$
Example:

"https://acme.example"

​
text_opt_out_message
string | null

Custom opt-out reply for SMS recipients. When omitted, a system default is used.

​
text_help_message
string | null

Custom HELP reply for SMS recipients. When omitted, a system default is used.

​
link_wrap_email
boolean | null

When true, links in email content are rewritten through the tracking domain.

​
link_wrap_push
boolean | null

When true, links in push payloads are rewritten through the tracking domain.

​
track_opens_email
boolean | null

When true, an open-tracking pixel is embedded in outgoing email.

​
deeplink_mirror_url
string | null

HTTPS-only mirror URL used for Universal Links and App Links resolution.

Pattern: ^(https:\/\/|$)
Example:

"https://links.acme.example"

Response

The newly created project.

Project as seen by an organisation API key (ok_). The publishable shape excludes internal credential storage and project-scoped fields such as the caller’s project role.

​
id
integer
required

Numeric project identifier.

Example:

42

​
organization_id
integer
required

Identifier of the owning organisation.

Example:

7

​
name
string
required

Human-readable project name.

Example:

"Acme Marketing"

​
locale
string
required

Default BCP-47 locale used for content rendering and timestamp formatting.

Example:

"en-AU"

​
timezone
string
required

Default IANA timezone used for time-of-day scheduling.

Example:

"Australia/Sydney"

​
created_at
string | null
required

Time the project was created. ISO 8601.

Example:

"2026-04-28T05:14:00.000Z"

​
updated_at
string | null
required

Time the project was last modified. ISO 8601.

Example:

"2026-04-28T05:14:00.000Z"

​
description
string | null

Optional free-text description of the project.

​
website_url
string | null

The project’s public website URL, if set.

Example:

"https://acme.example"

​
text_opt_out_message
string | null

Custom opt-out reply for SMS recipients. When omitted, a system default is used.

​
text_help_message
string | null

Custom HELP reply for SMS recipients. When omitted, a system default is used.

​
link_wrap_email
boolean | null

When true, links in email content are rewritten through the tracking domain.

​
link_wrap_push
boolean | null

When true, links in push payloads are rewritten through the tracking domain.

​
track_opens_email
boolean | null

When true, an open-tracking pixel is embedded in outgoing email.

​
deeplink_mirror_url
string | null

HTTPS-only mirror URL used for Universal Links and App Links resolution.

Example:

"https://links.acme.example"

​
role
enum<string>

Caller’s effective role on this project. Populated on single-project responses (create/update); omitted on the list endpoint to avoid per-row joins.

Available options:
support,
smtpproxy,
editor,
publisher,
admin
Example:

"admin"

​
has_provider
boolean

Whether the project has at least one delivery provider configured. Populated on single-project responses; omitted on the list endpoint.