# Fromenance docs

> Fromenance is a communication provenance platform for banks, credit unions, insurers, and utilities. Institutions register each outbound communication at send time; a customer forwards a suspicious message to verify@ on the institution's domain or pastes it on a verify page and gets Verified, Not verified, or Known fraud in seconds.

Integrating is one HTTPS call at send time plus a TXT record and a redirect rule. There is nothing to install. Base URL https://api.fromenance.com. Category: communication provenance. No model on the verdict path.

## Pages

- [Integration guide, end to end](https://docs.fromenance.com/getting-started/integration-guide): A numbered checklist a human or an AI agent can execute top to bottom to integrate Fromenance communication provenance with nothing to install. Every step has the exact request, the response fields to read, and how to confirm it worked.
- [What Fromenance does](https://docs.fromenance.com/getting-started): Fromenance is a communication provenance platform. Register every outbound communication at send time and answer "did you send this?" with Verified, Not verified, or Known fraud.
- [Quickstart](https://docs.fromenance.com/getting-started/quickstart): Go from an empty Fromenance tenant to a verified reply in 15 minutes with nothing to install. Create a key, publish the TXT record, create the redirect rule, register one email over HTTPS, paste the footer, forward it, read the reply.
- [Concepts](https://docs.fromenance.com/getting-started/concepts): The vocabulary of Fromenance communication provenance. Registration, verify code, fingerprint, recipient hash, verdicts, matching rules, footer replay, Authoritative Mode, coverage, sources, campaigns.
- [Domains and mail](https://docs.fromenance.com/domains-and-mail): The Fromenance trust model for communication provenance. The _fromenance TXT record, DKIM or ARC on redirected mail, why redirect and not forward, and every rejection reason.
- [Google Workspace](https://docs.fromenance.com/domains-and-mail/google): Click by click redirect rule for Google Workspace so forwards to verify@ reach the Fromenance communication provenance inbox with a DKIM pass.
- [Microsoft 365](https://docs.fromenance.com/domains-and-mail/microsoft-365): Click by click Exchange Online mail flow rule with "Redirect the message to" so forwards to verify@ reach the Fromenance communication provenance inbox with an ARC or DKIM pass.
- [Proofpoint](https://docs.fromenance.com/domains-and-mail/proofpoint): Where the redirect for verify@ lives in Proofpoint Email Protection and Essentials, what to set so the Fromenance communication provenance inbox receives an authenticated copy, and how to confirm with the forwarding test.
- [Mimecast](https://docs.fromenance.com/domains-and-mail/mimecast): Where the redirect for verify@ lives in Mimecast, what to set so the Fromenance communication provenance inbox receives an authenticated copy, and how to confirm with the forwarding test.
- [Cisco Secure Email](https://docs.fromenance.com/domains-and-mail/cisco-secure-email): Where the redirect for verify@ lives in Cisco Secure Email (Email Security Appliance and Cloud Gateway), what to set so the Fromenance communication provenance inbox receives an authenticated copy, and how to confirm with the forwarding test.
- [Branded replies](https://docs.fromenance.com/domains-and-mail/branded-replies): Send Fromenance communication provenance verdicts from verify@verify.yourdomain.com. The sending subdomain, the three DNS records issued through Resend, and the minimal reply identity for pilots.
- [Registering communications](https://docs.fromenance.com/registering): How to register outbound email with Fromenance for communication provenance over plain HTTPS. The register call, idempotency, the footer merge tag, recipient hashing, content fingerprints, batch, reserve, journal, and sandbox keys.
- [Resend](https://docs.fromenance.com/registering/resend): Register Resend sends with Fromenance for communication provenance. Create the source, point the Resend event webhook at it, Svix signature verification, the fromenance_code tag, body retrieval, and source health.
- [SendGrid](https://docs.fromenance.com/registering/sendgrid): Register SendGrid sends with Fromenance for communication provenance. Create the source, configure the Event Webhook, ECDSA signature verification, the reserve flow with custom_args.fromenance_code and the -fromenance_code- substitution tag, and source health.
- [Amazon SES](https://docs.fromenance.com/registering/amazon-ses): Register Amazon SES sends with Fromenance for communication provenance. Create the source, subscribe an SNS topic for Send and Delivery events, SNS signature verification, the reserve flow with the fromenance_code message tag, and source health.
- [Postmark](https://docs.fromenance.com/registering/postmark): Register Postmark sends with Fromenance for communication provenance. Create the source, add the Delivery webhook with HTTP basic auth, the fromenance_code metadata field, body retrieval through the Messages API, and source health.
- [Mailgun](https://docs.fromenance.com/registering/mailgun): Register Mailgun sends with Fromenance for communication provenance. Create the source, add the delivered webhook, HMAC signature verification with the webhook signing key, the v:fromenance_code variable, and source health.
- [Salesforce Marketing Cloud](https://docs.fromenance.com/registering/salesforce-marketing-cloud): Register Salesforce Marketing Cloud sends with Fromenance for communication provenance. Create the source, set up an Event Notification Service callback for EmailSent and EmailDelivered, HMAC signature verification, the AMPscript reserve pattern, and source health.
- [Braze](https://docs.fromenance.com/registering/braze): Register Braze email sends with Fromenance for communication provenance. Create the source, set up a Currents HTTP connector or webhook for Email Send and Delivery events, bearer token verification, the Connected Content reserve pattern with a Liquid attribute, and source health.
- [Generic webhook](https://docs.fromenance.com/registering/generic-webhook): Register sends from any system with the Fromenance generic webhook adapter for communication provenance. Create the source, post signed JSON send events, HMAC-SHA256 signature over the raw body, the reserve flow, and source health.
- [Verify page](https://docs.fromenance.com/verify-page): Put a Fromenance communication provenance verify page on your own domain. The embeddable widget from cdn.fromenance.com/verify.js, the iframe, site keys and allowed origins, theming, Turnstile escalation, and rate limits.
- [Verify page API](https://docs.fromenance.com/verify-page/api): The public submit API behind the Fromenance verify widget for communication provenance. Site key authentication, text, .eml, screenshot, and code inputs, the PublicVerdict response, polling for screenshots, Turnstile, and rate limits.
- [Verifications](https://docs.fromenance.com/verifications): Reading Fromenance communication provenance verdicts in the admin app and API. The submissions list and detail, signals, the link disabled preview, analyst overrides, CSV and STIX 2.1 exports, indicators, and the fraud list.
- [Webhooks](https://docs.fromenance.com/webhooks): Outbound webhooks from Fromenance to your SIEM, SOAR, or takedown vendor for communication provenance events. The event list, payload envelope, delivery headers, retry schedule, and replay from the admin app.
- [Verify signatures](https://docs.fromenance.com/webhooks/verify-signatures): Verify Fromenance webhook signatures in TypeScript, Python, and Go. The exact header names, the v1 HMAC-SHA256 scheme over timestamp and raw body, a 5 minute timestamp tolerance, and constant time comparison.
- [Admin](https://docs.fromenance.com/admin): Administering a Fromenance communication provenance tenant. The five roles (owner, admin, analyst, integrator, viewer), what each can do in the admin app and API, and where each setting lives.
- [Users and keys](https://docs.fromenance.com/admin/users-and-keys): Inviting users to a Fromenance communication provenance tenant, changing roles, and minting, scoping, and revoking API keys and site keys.
- [Retention and privacy](https://docs.fromenance.com/admin/retention-and-privacy): What a Fromenance communication provenance tenant stores, for how long, and what is never stored. Retention days, the 30 day submitter purge, raw MIME lifetime, and the data that never reaches Fromenance.
- [Errors](https://docs.fromenance.com/api/errors): How the Fromenance communication provenance API reports errors. RFC 9457 problem details, the errors[] array on validation failures, request ids, every problem type, and rate limit headers.
- [Overview](https://docs.fromenance.com/api): Integration documentation for the Fromenance communication provenance platform.
- [Health check](https://docs.fromenance.com/api/operations/healthz): Integration documentation for the Fromenance communication provenance platform.
- [Overview](https://docs.fromenance.com/api/operations/tags/communications): Integration documentation for the Fromenance communication provenance platform.
- [Search registrations](https://docs.fromenance.com/api/operations/v1communications/get): Integration documentation for the Fromenance communication provenance platform.
- [Register one sent communication](https://docs.fromenance.com/api/operations/v1communications/post): Integration documentation for the Fromenance communication provenance platform.
- [Register up to 1,000 communications](https://docs.fromenance.com/api/operations/v1communicationsbatch): Integration documentation for the Fromenance communication provenance platform.
- [Reserve a verify code before sending](https://docs.fromenance.com/api/operations/v1communicationsreserve): Integration documentation for the Fromenance communication provenance platform.
- [Registration detail with verifications against it](https://docs.fromenance.com/api/operations/v1communicationsid/get): Integration documentation for the Fromenance communication provenance platform.
- [Complete a reserved registration](https://docs.fromenance.com/api/operations/v1communicationsid/patch): Integration documentation for the Fromenance communication provenance platform.
- [Overview](https://docs.fromenance.com/api/operations/tags/public): Integration documentation for the Fromenance communication provenance platform.
- [Verify a message from the web page](https://docs.fromenance.com/api/operations/v1publicsubmit): Integration documentation for the Fromenance communication provenance platform.
- [Poll a screenshot submission](https://docs.fromenance.com/api/operations/v1publicverdicttoken): Integration documentation for the Fromenance communication provenance platform.
- [Submit a sales or pilot inquiry](https://docs.fromenance.com/api/operations/v1leads): Integration documentation for the Fromenance communication provenance platform.
- [List submissions](https://docs.fromenance.com/api/operations/v1submissions): Integration documentation for the Fromenance communication provenance platform.
- [Submission detail](https://docs.fromenance.com/api/operations/v1submissionsid): Integration documentation for the Fromenance communication provenance platform.
- [Analyst override](https://docs.fromenance.com/api/operations/v1submissionsidoverride): Integration documentation for the Fromenance communication provenance platform.
- [List extracted indicators](https://docs.fromenance.com/api/operations/v1indicators): Integration documentation for the Fromenance communication provenance platform.
- [The tenant's block list](https://docs.fromenance.com/api/operations/v1fraud-list/get): Integration documentation for the Fromenance communication provenance platform.
- [Add indicators to the fraud list](https://docs.fromenance.com/api/operations/v1fraud-list/post): Integration documentation for the Fromenance communication provenance platform.
- [Remove an entry](https://docs.fromenance.com/api/operations/v1fraud-listid): Integration documentation for the Fromenance communication provenance platform.
- [List domains](https://docs.fromenance.com/api/operations/v1domains/get): Integration documentation for the Fromenance communication provenance platform.
- [Add a domain](https://docs.fromenance.com/api/operations/v1domains/post): Integration documentation for the Fromenance communication provenance platform.
- [Domain detail](https://docs.fromenance.com/api/operations/v1domainsid/get): Integration documentation for the Fromenance communication provenance platform.
- [Remove a domain](https://docs.fromenance.com/api/operations/v1domainsid/delete): Integration documentation for the Fromenance communication provenance platform.
- [Change domain roles](https://docs.fromenance.com/api/operations/v1domainsid/patch): Integration documentation for the Fromenance communication provenance platform.
- [Re-check the TXT record now](https://docs.fromenance.com/api/operations/v1domainsidcheck): Integration documentation for the Fromenance communication provenance platform.
- [Create the branded reply identity](https://docs.fromenance.com/api/operations/v1domainsidreply-identity): Integration documentation for the Fromenance communication provenance platform.
- [Ask Resend to verify the reply identity records](https://docs.fromenance.com/api/operations/v1domainsidreply-identityverify): Integration documentation for the Fromenance communication provenance platform.
- [Forwarding test status](https://docs.fromenance.com/api/operations/v1domainsidforwarding-test/get): Integration documentation for the Fromenance communication provenance platform.
- [Send the forwarding test message to verify@<domain>](https://docs.fromenance.com/api/operations/v1domainsidforwarding-test/post): Integration documentation for the Fromenance communication provenance platform.
- [List sending sources with health](https://docs.fromenance.com/api/operations/v1sending-sources/get): Integration documentation for the Fromenance communication provenance platform.
- [Create a sending source](https://docs.fromenance.com/api/operations/v1sending-sources/post): Integration documentation for the Fromenance communication provenance platform.
- [Source detail](https://docs.fromenance.com/api/operations/v1sending-sourcesid/get): Integration documentation for the Fromenance communication provenance platform.
- [Delete a source](https://docs.fromenance.com/api/operations/v1sending-sourcesid/delete): Integration documentation for the Fromenance communication provenance platform.
- [Update a source](https://docs.fromenance.com/api/operations/v1sending-sourcesid/patch): Integration documentation for the Fromenance communication provenance platform.
- [Rotate the webhook secret](https://docs.fromenance.com/api/operations/v1sending-sourcesidrotate-secret): Integration documentation for the Fromenance communication provenance platform.
- [Run a synthetic send event through the adapter](https://docs.fromenance.com/api/operations/v1sending-sourcesidtest-event): Integration documentation for the Fromenance communication provenance platform.
- [All four reply templates](https://docs.fromenance.com/api/operations/v1reply-templates): Integration documentation for the Fromenance communication provenance platform.
- [Update a template](https://docs.fromenance.com/api/operations/v1reply-templatesoutcome): Integration documentation for the Fromenance communication provenance platform.
- [Render a template with sample data](https://docs.fromenance.com/api/operations/v1reply-templatesoutcomepreview): Integration documentation for the Fromenance communication provenance platform.
- [Send a test reply to yourself](https://docs.fromenance.com/api/operations/v1reply-templatesoutcometest): Integration documentation for the Fromenance communication provenance platform.
- [List endpoints](https://docs.fromenance.com/api/operations/v1webhook-endpoints/get): Integration documentation for the Fromenance communication provenance platform.
- [Create an endpoint](https://docs.fromenance.com/api/operations/v1webhook-endpoints/post): Integration documentation for the Fromenance communication provenance platform.
- [Delete an endpoint](https://docs.fromenance.com/api/operations/v1webhook-endpointsid/delete): Integration documentation for the Fromenance communication provenance platform.
- [Update an endpoint](https://docs.fromenance.com/api/operations/v1webhook-endpointsid/patch): Integration documentation for the Fromenance communication provenance platform.
- [Delivery log](https://docs.fromenance.com/api/operations/v1webhook-endpointsiddeliveries): Integration documentation for the Fromenance communication provenance platform.
- [Replay a delivery](https://docs.fromenance.com/api/operations/v1webhook-endpointsiddeliveriesdelivery_idreplay): Integration documentation for the Fromenance communication provenance platform.
- [Send a test verdict.created event](https://docs.fromenance.com/api/operations/v1webhook-endpointsidtest): Integration documentation for the Fromenance communication provenance platform.
- [Daily counts: registered, submitted, by outcome, by source, reply p95](https://docs.fromenance.com/api/operations/v1stats): Integration documentation for the Fromenance communication provenance platform.
- [Current user and tenant memberships](https://docs.fromenance.com/api/operations/v1me): Integration documentation for the Fromenance communication provenance platform.
- [Current tenant](https://docs.fromenance.com/api/operations/v1tenant/get): Integration documentation for the Fromenance communication provenance platform.
- [Update tenant settings](https://docs.fromenance.com/api/operations/v1tenant/patch): Integration documentation for the Fromenance communication provenance platform.
- [List tenant users](https://docs.fromenance.com/api/operations/v1users/get): Integration documentation for the Fromenance communication provenance platform.
- [Invite a user](https://docs.fromenance.com/api/operations/v1users/post): Integration documentation for the Fromenance communication provenance platform.
- [Remove a user from the tenant](https://docs.fromenance.com/api/operations/v1usersid/delete): Integration documentation for the Fromenance communication provenance platform.
- [Change a user's role](https://docs.fromenance.com/api/operations/v1usersid/patch): Integration documentation for the Fromenance communication provenance platform.
- [List API keys](https://docs.fromenance.com/api/operations/v1api-keys/get): Integration documentation for the Fromenance communication provenance platform.
- [Mint an API key](https://docs.fromenance.com/api/operations/v1api-keys/post): Integration documentation for the Fromenance communication provenance platform.
- [Revoke an API key](https://docs.fromenance.com/api/operations/v1api-keysid): Integration documentation for the Fromenance communication provenance platform.
- [Audit log](https://docs.fromenance.com/api/operations/v1audit): Integration documentation for the Fromenance communication provenance platform.
- [List site keys with embed snippets](https://docs.fromenance.com/api/operations/v1site-keys/get): Integration documentation for the Fromenance communication provenance platform.
- [Create a site key](https://docs.fromenance.com/api/operations/v1site-keys/post): Integration documentation for the Fromenance communication provenance platform.
- [Revoke a site key](https://docs.fromenance.com/api/operations/v1site-keysid/delete): Integration documentation for the Fromenance communication provenance platform.
- [Update a site key](https://docs.fromenance.com/api/operations/v1site-keysid/patch): Integration documentation for the Fromenance communication provenance platform.
- [Search submissions, registrations, and indicators](https://docs.fromenance.com/api/operations/v1search): Integration documentation for the Fromenance communication provenance platform.
- [Onboarding progress derived from tenant state](https://docs.fromenance.com/api/operations/v1setup): Integration documentation for the Fromenance communication provenance platform.
- [Security](https://docs.fromenance.com/security): The public security overview of the Fromenance communication provenance platform. Tenant isolation, per tenant AES-256-GCM keys, encrypted raw mail, HMAC recipient hashing, no LLM on the verdict path, the DKIM or ARC plus TXT trust model, infrastructure, subprocessors, disclosure, and data residency.
- [Changelog](https://docs.fromenance.com/changelog): Release notes for the Fromenance communication provenance platform, its API, widget, and admin app.

## Optional

- [Integration guide as Markdown](https://docs.fromenance.com/integration-guide.md): the end to end checklist in one small file
- [Full text](https://docs.fromenance.com/llms-full.txt): every docs page in one file
- [OpenAPI document](https://docs.fromenance.com/openapi.public.json): the public API contract, OpenAPI 3.1
- [Marketing site](https://fromenance.com/llms.txt): product, how it works, pricing, security