Documentation › Nexus Subscription › REST API

REST API for Nexus Subscription

Every HTTP endpoint the application exposes, grouped by resource.

Calling the API

The API is served from the same address as the application, under /api. Requests carry the session cookie issued at sign-in, so a browser session and an API call are the same identity and obey the same permissions.

Every state changing request (POST, PUT, PATCH, DELETE) must also carry this application family's presence header, or it is refused with 403 bad request. That refusal reads like a permissions fault but is not one. Integration and APIs lists the header per family.

Endpoints

86 endpoints in 28 resource groups.

activity · alerts · automation · collections · connect · countries · custom-domain · customers · fx · invoices · login · logout · next-number · nxdocs · nxdocs-file · nxtz · password · payments · perms · search · sender-domains · sender-emails · sender-options · sender-prefs · session · settings · username · users

activity 1

Method	Path	Access
GET	`/api/activity`	administrator

alerts 2

Method	Path	Access
GET	`/api/alerts`	signed in
POST	`/api/alerts/:id/resolve`	signed in

automation 3

Method	Path	Access
POST	`/api/automation/run`	administrator
GET	`/api/automation/status`	signed in
PUT	`/api/automation/toggles`	administrator

collections 1

Method	Path	Access
GET	`/api/collections`	signed in

connect 25

Method	Path	Access
GET	`/api/connect/connections`	signed in
POST	`/api/connect/connections`	signed in
DELETE	`/api/connect/connections/:id`	signed in
PUT	`/api/connect/connections/:id`	signed in
POST	`/api/connect/connections/:id/call`	signed in
POST	`/api/connect/connections/:id/test`	signed in
GET	`/api/connect/hooks`	signed in
POST	`/api/connect/hooks`	signed in
DELETE	`/api/connect/hooks/:id`	signed in
PUT	`/api/connect/hooks/:id`	signed in
GET	`/api/connect/hooks/:id/events`	signed in
GET	`/api/connect/log`	signed in
GET	`/api/connect/meta`	signed in
GET	`/api/connect/subs`	signed in
POST	`/api/connect/subs`	signed in
DELETE	`/api/connect/subs/:id`	signed in
PUT	`/api/connect/subs/:id`	signed in
POST	`/api/connect/subs/:id/test`	administrator
GET	`/api/connect/tokens`	signed in
POST	`/api/connect/tokens`	signed in
DELETE	`/api/connect/tokens/:id`	signed in
PUT	`/api/connect/tokens/:id`	signed in
POST	`/connect/hook/:slug`	signed in
GET	`/connect/mcp`	signed in
POST	`/connect/mcp`	signed in

countries 1

Method	Path	Access
GET	`/api/countries`	signed in

custom-domain 3

Method	Path	Access
GET	`/api/custom-domain`	signed in
PUT	`/api/custom-domain`	signed in
POST	`/api/custom-domain/verify`	signed in

customers 5

Method	Path	Access
GET	`/api/customers`	signed in
POST	`/api/customers`	signed in
GET	`/api/customers/:id`	signed in
PUT	`/api/customers/:id`	signed in
POST	`/api/customers/:id/engage`	signed in

fx 4

Method	Path	Access
GET	`/api/fx`	signed in
PUT	`/api/fx`	administrator
GET	`/api/fx/convert`	signed in
POST	`/api/fx/refresh`	administrator

invoices 3

Method	Path	Access
GET	`/api/invoices`	signed in
POST	`/api/invoices`	signed in
GET	`/api/invoices/:id`	signed in

Method	Path	Access
POST	`/api/login`	public
POST	`/api/login/2fa`	public

logout 1

Method	Path	Access
POST	`/api/logout`	signed in

next-number 1

Method	Path	Access
GET	`/api/next-number`	signed in

nxdocs 2

Method	Path	Access
GET	`/api/nxdocs/:kind/:ref`	signed in
POST	`/api/nxdocs/:kind/:ref`	signed in

nxdocs-file 2

Method	Path	Access
DELETE	`/api/nxdocs-file/:id`	signed in
GET	`/api/nxdocs-file/:id`	signed in

nxtz 3

Method	Path	Access
GET	`/api/nxtz`	signed in
PUT	`/api/nxtz`	signed in
POST	`/api/nxtz/device`	signed in

password 2

Method	Path	Access
POST	`/api/password/forgot`	public
POST	`/api/password/reset`	signed in

payments 4

Method	Path	Access
GET	`/api/payments`	signed in
POST	`/api/payments`	signed in
POST	`/api/payments/:id/reassign`	signed in
POST	`/api/payments/:id/void`	signed in

perms 2

Method	Path	Access
GET	`/api/perms/catalog`	signed in
GET	`/api/perms/resolved`	administrator

search 2

Method	Path	Access
GET	`/api/search`	signed in
GET	`/api/search/coverage`	signed in

sender-domains 1

Method	Path	Access
GET	`/api/sender-domains/:domain/dkim`	signed in

sender-emails 6

Method	Path	Access
POST	`/api/sender-emails`	signed in
DELETE	`/api/sender-emails/:id`	signed in
PUT	`/api/sender-emails/:id`	signed in
POST	`/api/sender-emails/:id/primary`	signed in
POST	`/api/sender-emails/:id/resend`	signed in
POST	`/api/sender-emails/:id/verify`	signed in

sender-options 1

Method	Path	Access
GET	`/api/sender-options`	signed in

sender-prefs 1

Method	Path	Access
GET	`/api/sender-prefs`	signed in

session 1

Method	Path	Access
GET	`/api/session`	signed in

settings 2

Method	Path	Access
GET	`/api/settings`	administrator
PUT	`/api/settings`	administrator

username 1

Method	Path	Access
POST	`/api/username/forgot`	public

users 4

Method	Path	Access
GET	`/api/users`	administrator
POST	`/api/users`	administrator
DELETE	`/api/users/:id`	administrator
PUT	`/api/users/:id`	administrator