The email API surface has two sub-resources: a status read for the tenant's email configuration, and a full CRUD surface for notification email templates under /api/v1/email/templates.
GET /api/v1/email returns the tenant's current email configuration. Treat it as a status read — there is no create or send endpoint on this resource. If you need to drive inbound mail into AlgaPSA, model it as an inbound webhook instead.
Notification email templates can be read and customised programmatically. Each template is identified by a name (for example ticket.created) and a language code. The list endpoint merges system-default templates with any tenant overrides so you always see the effective template for every notification type and language combination. Write and delete operations require the settings write permission and are flagged as requiring approval in the AI/MCP tool registry.
| Method | Path | Purpose |
|---|---|---|
GET | /api/v1/email/templates | List all effective templates. Filterable by name, language, category, and customized (pass customized=true to return only templates the tenant has overridden). |
GET | /api/v1/email/templates/{name} | Read one template by name; returns the merged system default when the tenant has not yet overridden it |
PUT | /api/v1/email/templates/{name} | Upsert a tenant override. On the first write the system default is cloned as the starting point; subsequent writes replace the stored HTML, subject, and plain-text body. |
DELETE | /api/v1/email/templates/{name} | Remove the tenant override for a specific template and language, restoring the system default |
Every endpoint links through to its full parameters, request and response schemas, and code samples.
POST/api/email/oauth/initiateAlgaPSAAlgaDeskInitiate email OAuth flowPOST/api/email/refresh-watchAlgaPSARefresh Gmail watch registrationPOST/api/email/webhooks/googleAlgaPSAReceive Google Gmail Pub/Sub webhook/api/email/webhooks/googleAlgaPSACORS preflight for Google email webhookGET/api/email/webhooks/microsoftAlgaPSAValidate Microsoft email webhook subscriptionPOST/api/email/webhooks/microsoftAlgaPSAReceive Microsoft Graph email webhook/api/email/webhooks/microsoftAlgaPSACORS preflight for Microsoft email webhookPOST/api/email/webhooks/testAlgaPSAPublish test inbound email eventGET/api/v1/emailAlgaPSAAlgaDeskEmail API namespace rootGET/api/v1/email/templatesAlgaPSAList email templatesGET/api/v1/email/templates/{name}AlgaPSAGet email templatePUT/api/v1/email/templates/{name}AlgaPSAUpdate email templateDELETE/api/v1/email/templates/{name}AlgaPSAReset email template