Mailboxes

Create Sender Persona

Create a sender persona - an identity mailboxes can be bought under.

Give first_name, last_name and email, or a team_member_id to take them from. The identity is registrant data at the registrar for every domain bought under it, so use a real person who has agreed to it.

409 if the email is already a persona. Org admins and owners only, and a personal API key.

post/mailboxes/personas

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/mailboxes/personas
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

first_namestring nullable

Given name

last_namestring nullable

Family name

emailstring nullable

The persona's own address

phonestring nullable

Contact phone

titlestring nullable

Job title shown in signatures

organizationstring nullable

Organisation name

address_line1string nullable

Registrant address, line 1

address_line2string nullable

Registrant address, line 2

citystring nullable

City

statestring nullable

State or region

countrystring nullable

Country

postal_codestring nullable

Postal code

photo_urlstring nullable

Photo URL

team_member_idstring uuid nullable

Team member whose identity this persona uses

Response

Successful Response

dataMailboxDomainPayload required

An open envelope for one provider/deliverability result.

Open on purpose. These payloads are provider state and advisory reads whose contents grow with the product, and a dropped field reads as "nothing to report" rather than "we did not tell you". Every value passes through scrub_vendor_names on the way in.

Changes

No recorded changes to this operation across all 2 revisions of this API.