Skip to content

Delete Email Template

Deletes an email template — the Delete row action on the admin Marketing → Communications → Email Templates screen.

TIP

New here? Read the Email Templates overview for what an email template does and how its fields behave.

Operation

OperationTypePurpose
deleteAdminMarketingTemplateMutationDelete an email template

Details

  • Requires an admin Bearer token and the marketing.communications.email_templates.delete permission.
  • Pass the template's IRI as id. Use the list query to discover valid ids.

Confirm success via the absence of errors

The delete mutation returns a success acknowledgement, not the deleted template's data — adminMarketingTemplate resolves to null on the payload. Treat a response with no errors[] as a successful delete. If you need a confirmation message in the body, use the REST endpoint (DELETE /api/admin/marketing/templates/{id}), which returns { "message": "Email template deleted." }.

Input fields

FieldTypeRequiredNotes
idIDYesThe template's IRI

Released under the MIT License.