Automate the Marketing Portal

Grant the Marketing scopes your integration needs. Check entitlement for features and limits.

Manage email signatures

List generators for the ID and read the draft for its revision. Send the complete configuration and current revision to replace the draft. Refresh the draft after a revision conflict.

Use marketing:signatures:manage to create a generator, rename it, or delete it. Use marketing:signatures:publish to publish or unpublish at the current revision. Changing a published slug requires both scopes.

Connect a custom hostname and follow the DNS instructions. Verify it before sharing its link.

Manage Microsoft 365 signatures

Start the connection in the Portal as a Space owner or admin. A Microsoft administrator grants tenant consent. Outlook employee requests use Microsoft identity.

Check the connection and read the policy revision. Use separate grants to save, preview, and publish. Directory synchronization, sender grants, and audit events have their own scopes.

Each Microsoft 365 connection shares 30 previews per minute and 3 sync queue requests per minute across the API and Portal. After you queue a sync, check the connection status for progress. These connection allowances apply alongside the Developer API quotas.

Work with the brand kit

Read the brand kit for profile and asset IDs. Remove a profile's assets before deleting it.

Upload a brand asset as image bytes, up to 2 MiB, with a matching Content-Type. Examples read DASHIO_UPLOAD_FILE. Persist an Idempotency-Key for profile changes and uploads. Use the asset read scope to download files.

Build and manage tracked links

Read the UTM workspace with collection set to campaigns (default), links, or presets. Preview a tracked URL before saving it.

For each UTM change, persist an Idempotency-Key. Retry with the same key and body within seven days. Reusing the key with another body returns 409.

Generate QR codes and inspect sites

Generate a QR code for an HTTP or HTTPS URL. The encoded URL preserves its query and fragment. An optional inline logo must be a complete static PNG, JPEG, or WebP image of up to 2 MiB decoded and 512 pixels per side. Reuse the returned SVG when the URL and design are unchanged.

Inspect an authorized Space hostname using a public HTTP or HTTPS URL on its default port. Omit the query and credentials. Saving inspection history requires marketing:inspections:save.

The Space's Marketing plan also sets shared minute and UTC-day allowances for QR generation and inspection across the API and Portal. Read the Marketing overview for the current plan allowances. QR generation shares the API's hourly rendering quota with Microsoft 365 previews. Site inspection has its own hourly quota. On 429, honor Retry-After before retrying.

Read subscription status

Read the Signatures subscription or scheduled plan change. Use the Portal for checkout and billing changes.