[ MSP, APIs & integrations ]

PSA integration requirements for an MSP authentication service

Specify the customer lifecycle, data boundary and acceptance evidence before choosing a PSA integration.

By the EmailAuth research team · 3 min read

[ Key points ]

  • Specify the customer lifecycle, data boundary and acceptance evidence before choosing a PSA integration.
  • Separate service agreement, destination mapping, failure testing and exit acceptance; a working API call does not establish the whole service.
On this page

A professional services automation integration connects technical findings with commercial and service responsibilities. It should identify who receives work, which customer agreement applies and what happens when the relationship ends. An API connection alone does not provide those answers.

Begin with the service agreement

Define the managed domains, sending services, monitoring coverage, change authority and escalation hours. Distinguish permission to read reports from permission to alter DNS or communicate with a customer's contacts. Name the customer sponsor, MSP service owner, technical operator, change approver and privacy contact.

State the responsibilities that can actually be measured: acknowledgment of a qualifying incident, maintenance of the sender register, review of unresolved exceptions and delivery of an evidence summary. Do not promise that every message will pass or reach an inbox. DMARC alignment under RFC 9989 is only part of email handling, and report coverage under RFC 9990 is not a complete mail census.

Build a lifecycle with acceptance gates

Use separate acceptance decisions for authorization, mapping, failure testing, operations, changes and exit. Suppose the API read succeeds but the approved service queue was removed and no replacement owner is confirmed. Documentary connectivity passed; operational routing has not. Hold automatic dispatch until the destination map and accountable owner are approved and tested.

Separately, a customer may approve report reading while withholding customer notifications and DNS changes. Do not expand that grant merely to make the pilot feel complete. These are hypothetical gaps, not a supplied lifecycle runbook, executed completeness check or commercial SLA. Define any response target with its calendar, severity, dependencies and pause rules before promising it.

Map technical events to service records

Maintain customer, site, contract, service, queue, priority and status mappings as versioned configuration. Resolve each value against the selected PSA's current interface. For example, Autotask documents ticket fields and configuration-dependent requirements; those rules cannot be assumed to apply identically to other PSAs.

Include a stable external correlation key, destination record ID and evidence reference. Retain observation time separately from ticket creation time. Minimize exported data: a technical summary and restricted evidence link are usually more appropriate than full message content. Review who can see notes and attachments, including co-managed customer users.

Accept failure behavior as part of the product

The pilot must cover a duplicate event, an uncertain create, a revoked credential, a removed queue, a closed customer and an unauthorized tenant reference. Set bounded retries for transient failures and a staffed recovery queue for permanent ones. Reconcile before retrying an operation that may already have succeeded.

Require verification before closing a technical incident. A PSA status change does not demonstrate restored authentication. Preserve human decisions and explain when the integration may reopen or append to a record. Check customer-notification side effects before enabling automatic updates.

Make offboarding reversible where possible

Stop new ingestion and routing under the agreed plan, export evidence to an authorized recipient and revoke integration access. Identify retention obligations and deletion approvals separately. Do not automatically remove working DNS records when a billing status changes: those records may still protect the customer's mail. A service suspension, a permission revocation and a technical configuration change are separate decisions.

This is an integration requirements method, not proof that EmailAuth supports a particular PSA. Acceptance remains conditional on actual documentation, authorized tenant tests and accountable customer sign-off.

[ Takeaway ]

Separate service agreement, destination mapping, failure testing and exit acceptance; a working API call does not establish the whole service.

[ By role ]

What this means for you

Choose your role for practical next steps.

IT / Mail Admin

Version the lifecycle

Mappings and service states change during a customer relationship.

Next steps

  1. Keep mapping revisions.
  2. Test revoked and missing targets.
  3. Reconcile technical handover.

CISO / SecOps

Review the access boundary

Commercial systems can expose technical evidence broadly.

Next steps

  1. Check note and attachment visibility.
  2. Require scoped access.
  3. Approve retention and export recipients.

Founder / Non-technical

Sell defined responsibility

A service promise needs measurable work and clear dependencies.

Next steps

  1. Approve scope and coverage.
  2. Distinguish support from change authority.
  3. Review exit obligations.

[ FAQs ]

Frequently asked questions

What should be agreed before API access?

Customer scope, responsibilities, permissions, escalation coverage and evidence handling.

Does this guide promise a response-time SLA?

No. Any real target needs an approved service agreement defining coverage, severity, clocks, pauses and dependencies.

Can one field map serve every PSA?

No. Validate the selected system and customer configuration.

Why test a removed queue?

It exposes permanent mapping failures that a happy-path create test misses.

Should suspension delete DNS records?

Not automatically. Mail continuity and DNS changes need their own approved plan.

Does a ticket closure prove recovery?

No. Require technical evidence appropriate to the affected service.

What should offboarding produce?

Approved exports, access-revocation receipts, retention decisions and an accountable handover.

What do the acceptance examples establish?

They illustrate separate connectivity, routing and authority decisions. No live service performance or lifecycle completeness test is asserted.

[ Sources ]

Sources

  1. Autotask REST API: Tickets

    Sections Entity URLs and relationships · Conditions and requirements · Special field attributes

  2. RFC 9989: Domain-based Message Authentication, Reporting, and Conformance

    Sections §4.4 · §5.3.5 · §5.4 · §7.4 · §8

  3. RFC 9990: DMARC Aggregate Reporting

    Sections §3.1 · §3.1.1.4 · §3.1.2 · §3.5.1 · §3.5.4 · §4 · §7 · §8

[ Glossary ]

Glossary

PSA
Professional services automation system used to organize customer service work.
Acceptance gate
Evidence required before a workflow moves into its next stage.

Enterprise provenance

Why top financial institutions and governments retired their email security dashboards.

Traditional email authentication platforms sell you a dashboard and ask your engineers to do the labour. In high-stakes environments, manual oversight means delayed enforcement, configuration drift and unmonitored shadow domains.

EmailAuth is the agentic email provenance platform. Our agents enforce p=reject, keep third-party senders aligned and move your domains to full RFC 9989 compliance, the new DMARC standard,, with human-in-the-loop auditability.

Governments Large enterprises Tier-1 financial institutions

SaaS · Dedicated tenancy · Air-gapped on-prem · BYOK encryption

Knowledge Base