Customize how Agent Account email looks

These settings change how messages from an Agent Account appear to recipients.

Customization	What recipients see	Where you set it
Display name	A name next to the sender address	`name` on the grant, or `from` on a message
Signature	An HTML signature at the end of the message	Signatures API and `signature_id`
Reply address	Replies go to another address	`reply_to` on a message
Tracking domain	Tracked links on your own hostname	`tracking_options.domain_name`
Logo	Your logo as the sender avatar, and a blue checkmark in Gmail	A BIMI record in your DNS

Set the sender display name

Nylas uses the top-level name that you set when you create the Agent Account as the From name on messages and calendar invitations. If the account has no name, messages show only the email address. To rename the account, send a new name in a PATCH /v3/grants/{grant_id} request. The name can be 1 to 256 characters. The next message the account sends uses the new name.

To use a different name on one message, set from to the account’s address and the name you want. If the address in from doesn’t match the Agent Account, the send fails with 403.

Messages sent from a mail client over SMTP submission use the From name that the client sets. Nylas doesn’t add the stored name to these messages.

Add an email signature

Agent Accounts support the Signatures API. Each account can have up to 10 HTML signatures, and each signature can be up to 100 KB. To add a signature to a message or draft, pass its signature_id. Nylas adds the signature to the end of the HTML body. Messages without a signature_id get no signature.

Signatures work only with HTML bodies. A send that sets both is_plaintext: true and signature_id fails with 400. To create and manage signatures, see Using email signatures.

Send replies to a different address

Set reply_to to send replies to an address other than the Agent Account. The addresses in reply_to can be on any domain.

This request sets a display name, a reply address, and a signature on one message. These values apply to this message only. They don’t change the account’s settings. Drafts accept the same fields.

curl --request POST \
  --url "https://api.us.nylas.com/v3/grants/<NYLAS_GRANT_ID>/messages/send" \
  --header "Authorization: Bearer <NYLAS_API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{
    "from": [{ "name": "Acme Support", "email": "[email protected]" }],
    "reply_to": [{ "name": "Acme Support Team", "email": "[email protected]" }],
    "to": [{ "name": "Leyah Miller", "email": "[email protected]" }],
    "subject": "Your ticket has been resolved",
    "body": "<p>Hi Leyah, we fixed the sync issue you reported.</p>",
    "signature_id": "<SIGNATURE_ID>"
  }'

Use your own domain for tracked links

When open or link tracking is on, tracked links and the tracking image use the Nylas regional tracking hostname. To use your own hostname, such as links.yourcompany.com, register it and pass it in tracking_options.domain_name.

Custom tracking hostnames are available on the annual Pro plan with the Accelerator add-on, and on Enterprise plans. To register a hostname, add two CNAME records and verify them in the Dashboard. For the steps, see Use a custom tracking hostname.

Show your logo in email clients

BIMI (Brand Indicators for Message Identification) shows your logo as the sender avatar for messages from your domain. You set it up with a DNS record on your domain. You don’t change anything in Nylas. All Agent Accounts on a domain show the same logo.

Gmail, Apple Mail, Yahoo, and Fastmail support BIMI. Outlook doesn’t. Some clients require a mark certificate, either a Verified Mark Certificate (VMC) or a Common Mark Certificate (CMC).

Email client	Certificate needed	Source
Gmail (web, Android, iOS)	VMC or CMC. The blue checkmark needs a VMC.	Google Workspace Admin Help
Apple Mail (iOS 16, macOS 13, and later) and iCloud.com	VMC. Apple names no other certificate type.	Apple Support
Yahoo Mail	None. Yahoo shows logos only for bulk senders with enough reputation.	Yahoo Sender Hub
Fastmail	Optional	Fastmail Help
Outlook and Microsoft 365	BIMI isn’t supported	Microsoft Learn

Set up BIMI in this order

You

Start with a verified Agent Account domain

Agent Account messages already pass SPF and DKIM for the domain.

Domain

Your DNS

Enforce DMARC

p=quarantine with pct=100, or p=reject, on the domain and its parent domain.

Logo

You

Make the SVG Tiny PS logo

A square SVG in the SVG Tiny PS format, under 32 KB.

Certificate authority

Get a mark certificate

A VMC needs a registered trademark and adds the Gmail checkmark. A CMC shows the logo only.

You

Host the logo and certificate

Both files at public HTTPS URLs.

Your DNS

Publish the BIMI record

A TXT record at default._bimi.<your-domain> with l= for the logo and a= for the certificate.

You

Check the setup

Look up the record with dig, then send a test message to a Gmail or Apple Mail address.

DMARC and the logo can be prepared at the same time. The certificate needs the finished logo file, and the BIMI record needs the hosted logo and certificate.

Diagram as text

You: Start with a verified Agent Account domain: Agent Account messages already pass SPF and DKIM for the domain.
All of these, in any order:
- Domain
  - Your DNS: Enforce DMARC: p=quarantine with pct=100, or p=reject, on the domain and its parent domain.
- Logo
  - You: Make the SVG Tiny PS logo: A square SVG in the SVG Tiny PS format, under 32 KB.
  - Certificate authority: Get a mark certificate: A VMC needs a registered trademark and adds the Gmail checkmark. A CMC shows the logo only.
You: Host the logo and certificate: Both files at public HTTPS URLs.
Your DNS: Publish the BIMI record: A TXT record at default._bimi.<your-domain> with l= for the logo and a= for the certificate.
You: Check the setup: Look up the record with dig, then send a test message to a Gmail or Apple Mail address.

Prepare the logo file

BIMI uses an SVG Tiny Portable/Secure (SVG Tiny PS) file: a Scalable Vector Graphics (SVG) logo in a restricted format that mail clients can display safely. Most logos start as a PNG, so the file takes a few steps to make.

Get a vector version of the logo. Use your square icon or symbol, not a wide version that includes your company name, as an SVG or Adobe Illustrator file from your designer or brand assets. If you only have a PNG or JPEG, a designer can redraw it as a vector, or you can use an AI agent.
Make it square. Center the logo on a solid background color. Mail clients show the logo in a circle, square, or rounded square, so leave space around the edges, as the BIMI Group’s logo display guide describes.
Convert it to SVG Tiny PS. Paste the SVG into the BIMI Group’s SVG Assistant, enter your company name as the title, and copy the converted file. The title is a required <title> element that names the logo. For other tools, including an Adobe Illustrator script, see the BIMI Group’s guide to creating BIMI SVG logo files.
Check the file size. Keep the file under 32 KB.

The mark certificate includes this SVG file, so you need it before you apply for a certificate.

Make the SVG with an AI agent

You might want to use your AI agent to make the SVG Tiny PS file from a PNG or JPEG. Use an agent that can run code, so it can render the SVG and compare it with your image. Attach the image and start from the sample prompt below, then adjust it for your logo. The prompt has the agent measure the image, build the logo from shapes, and repeat the render-and-compare step until the SVG matches the original. Check the result against your original logo, and run it through the SVG Assistant before you use it.

Sample prompt: convert a PNG logo to SVG Tiny PS

Recreate the attached logo as an SVG for BIMI, in the SVG Tiny Portable/Secure (SVG Tiny PS) profile. Use code to measure the image and to check your result.

Match the original exactly: the same shapes, positions, proportions, and colors. Don't simplify, restyle, or "improve" the design. Don't use an automatic bitmap tracer. Build the logo from shapes. Leave out drop shadows, glows, and gradients, and use flat colors.

1. Describe the logo. List every shape, its color, and how the shapes relate to each other, such as concentric arcs, parallel lines, equal spacing, rounded ends, or symmetry.
2. Measure the edges with code. Load the image and use its pixel dimensions as the coordinate system. Pixel (i, j) covers the square from i to i+1, so its center is at (i + 0.5, j + 0.5) in SVG coordinates. Place each edge where the color is halfway between the background and the shape color, and interpolate between pixels to get sub-pixel positions. Measure edges along at least 6 horizontal and 6 vertical lines, and at right angles to angled and curved edges. Fit circles to curved edges to find their centers and radii.
3. Work out the geometry. Calculate stroke widths, gaps, radii, centers, and end points from the measured edges.
4. Write the SVG. Use lines, arcs, and circles with stroke widths and round caps for regular shapes. Draw each half circle as two quarter-circle arcs, because a single 180° arc can render in the wrong place. Draw shapes that aren't regular, such as letters or flattened curves, as filled paths that follow the measured outline. Shapes can overlap. For example, a circle in the background color can cut a notch out of a stroke.
5. Render and compare. Render the SVG at the image's size and compare it with the original pixel by pixel. Count a pixel as part of the logo when its color is at least halfway from the background color to the logo color. Calculate the overlap as intersection over union (IoU), and find where the two images differ. Check each measured edge at right angles to the edge.
6. Improve and repeat. Adjust the geometry where the images differ, and go back to step 5. Stop when the IoU is at least 0.99, no edge is more than 1 pixel off, and the remaining differences are only along anti-aliased edges.

The SVG must follow these rules:

- The root element is `<svg xmlns="http://www.w3.org/2000/svg" version="1.2" baseProfile="tiny-ps" viewBox="0 0 S S">`. If the image is square, S is its width. If it isn't, make S large enough to center the logo with space on every side.
- The first child of `<svg>` is `<title><YOUR COMPANY NAME></title>`.
- Don't put `x`, `y`, `width`, or `height` attributes on the root `<svg>` element.
- Draw the background as a full-size `<rect>` in the logo's background color. If the image has a transparent background, use white.
- Use the exact colors from the image, as hex values sampled from the pixels.
- Don't use `<script>`, `<image>`, `<foreignObject>`, `<a>`, `<text>`, animation elements, event attributes, or references to external files.
- Keep the file under 32 KB.

Return the final IoU and the complete SVG in one code block.

Choose a mark certificate

A mark certificate proves that you own the logo. The certificate type sets what Gmail shows, according to Google’s BIMI setup guide:

VMC: Gmail shows the logo and a blue checkmark next to the sender name. A VMC requires a registered trademark for the logo.
CMC: Gmail shows the logo without the checkmark.
No certificate: Gmail doesn’t show a logo.

Buy the certificate from an authority on the BIMI Group’s list. The certificate authority sets the requirements for each certificate type.

Set up BIMI

Enforce DMARC. Agent Account messages already pass SPF and DKIM for your domain. Set your domain’s DMARC policy to p=quarantine with pct=100, or to p=reject. BIMI doesn’t work with p=none. If you set sp= for subdomains, it can’t be none. To roll out the policy in stages, see Set up DMARC.
Host the logo. Host the SVG Tiny PS file from Prepare the logo file at a public HTTPS URL.
Host the certificate. Host the certificate file, a Privacy-Enhanced Mail (PEM) file, at a public HTTPS URL.
Publish the BIMI record. Add a TXT record at default._bimi.<your-domain>. Set l= to the logo URL and a= to the certificate URL. Use the default selector, because Nylas doesn’t set a BIMI-Selector header. The BIMI Group’s Record Builder generates the record value.

This is the record for the domain yourcompany.com:

default._bimi.yourcompany.com.  IN  TXT  "v=BIMI1; l=https://yourcompany.com/bimi/logo.svg; a=https://yourcompany.com/bimi/certificate.pem"

If your Agent Accounts use a subdomain, such as agents.yourcompany.com, you can publish the record on the subdomain. If the subdomain has no record, mail providers use the record on yourcompany.com, as described in the BIMI draft. The parent domain also needs a p=quarantine or p=reject DMARC policy. To use a different logo for one account, put the account on a separate subdomain with its own record.

Check your BIMI setup

Run dig to see the BIMI record that mail providers see. If it returns nothing, the record is missing or has the wrong host name. Some DNS providers add your domain to the host name, so enter default._bimi as the host.

dig +short TXT default._bimi.yourcompany.com

The BIMI Group’s record checker checks the record format and your DMARC policy. It doesn’t check the SVG file or the certificate. To see the logo, send a message from the Agent Account to a Gmail or Apple Mail address you control.

If the logo doesn’t appear, check for these problems:

DMARC isn’t enforced on the sending domain or its parent domain, or pct is below 100 with p=quarantine.
The logo isn’t valid SVG Tiny PS.
A file is served over HTTP, or its URL redirects or returns an error.
The domain’s reputation is too low. Mail providers can withhold logos from domains with high bounce or complaint rates. To check your rates, see Monitor delivery and engagement.

Show your logo in Apple Mail without a certificate

Apple Branded Mail shows your brand name and logo in the Mail app on Apple devices and in iCloud Mail on the web. It doesn’t use BIMI or a mark certificate. You set it up in Apple Business. Apple requires DMARC on the domain and DKIM on all mail. Agent Accounts sign mail with your domain’s DKIM key.

Set up Apple Branded Mail in this order

You

Use an Organization Administrator or Marketing Administrator account. These roles can manage Branded Mail.

Apple

Verify your organization

Submit two verification methods in Settings > Organization, such as a D-U-N-S Number and a DNS TXT record.

Brand

You

Add your brand and logo

In Brands > Brand Profiles. Apple reviews the brand and logo.

Domain

You

Set up Branded Mail

In Brands > Branded Mail, add the Agent Account domain, a subdomain, or one email address.

Your DNS

Publish Apple's TXT record

Copy the TXT record from Apple Business, add it to your DNS, then select Verify.

Apple

Approve the brand and email domain

Each domain or address shows a status of In review, Approved, Not approved, or Incomplete.

Apple Mail

Show your logo

In the Mail app on Apple devices and in iCloud Mail on the web.

Apple verifies your organization first. After that, you can add your brand and set up Branded Mail for your domain. Apple approves both before your logo appears.

Diagram as text

You: Sign up for Apple Business: Use an Organization Administrator or Marketing Administrator account. These roles can manage Branded Mail.
Apple: Verify your organization: Submit two verification methods in Settings > Organization, such as a D-U-N-S Number and a DNS TXT record.
All of these, in any order:
- Brand
  - You: Add your brand and logo: In Brands > Brand Profiles. Apple reviews the brand and logo.
- Domain
  - You: Set up Branded Mail: In Brands > Branded Mail, add the Agent Account domain, a subdomain, or one email address.
  - Your DNS: Publish Apple's TXT record: Copy the TXT record from Apple Business, add it to your DNS, then select Verify.
Apple: Approve the brand and email domain: Each domain or address shows a status of In review, Approved, Not approved, or Incomplete.
Apple Mail: Show your logo: In the Mail app on Apple devices and in iCloud Mail on the web.

Sign up for Apple Business. Create an Apple Business account with a user that has the Organization Administrator or Marketing Administrator role. These roles can manage Branded Mail.
Verify your organization. In Settings > Organization, select Verify Now and submit two verification methods, such as a D-U-N-S Number and a DNS TXT record. You can’t add a brand or set up Branded Mail until Apple verifies the organization.
Add your brand and logo. In Brands > Brand Profiles, add a brand and upload a logo that meets Apple’s logo requirements. Then send it for review.
Set up Branded Mail. In Brands > Branded Mail, select Set up Branded Mail, choose the brand, and add the Agent Account domain, a subdomain, or one email address. For the full steps, see Set up Branded Mail.
Verify the domain. Copy the TXT record from Apple Business, add it to your domain’s DNS, and select Verify. See Verify your domain name for Branded Mail.
Wait for approval. Apple approves each domain or email address before the logo appears. Check the status in Brands > Branded Mail.

Show a profile photo in Gmail with a Google Account

Gmail can show a Google Account profile photo next to messages from that account’s address. You can create a Google Account with the Agent Account’s address, because Google Accounts accept non-Gmail addresses. Google sends a verification code to the address, which arrives in the Agent Account’s inbox. Then set a profile photo on the Google Account.

Google’s Gmail Help says the profile photo can appear next to your name and in notifications for messages you send to Gmail users. We recommend BIMI instead. BIMI works in Gmail, Apple Mail, Yahoo, and Fastmail, and it’s the method Google documents for brand logos.

How Agent Account email looks in Outlook

Outlook shows the sender’s display name and address. It doesn’t support BIMI, and Microsoft has no way for a sender to set the logo or photo that Outlook users see. The sender avatar comes from the recipient’s side: a photo the recipient saved on their own contact for the address, a LinkedIn photo if the recipient’s organization has LinkedIn turned on, or Outlook’s default avatar.

Outlook can add these labels to a message. Messages from an Agent Account on a verified domain pass SPF and DKIM for your domain, so Outlook doesn’t add the ? or via label. The other labels depend on the recipient.

Label	When Outlook shows it	Who controls it
`?` on the sender photo	The message fails authentication.	The sender. Agent Account messages pass.
`via` next to the sender	The DKIM or `MAIL FROM` domain doesn’t match the `From` domain.	The sender. Agent Account messages match.
”You don’t often get email from…”	The recipient rarely or never gets email from the sender.	The recipient’s admin.
`External`	The message comes from outside the recipient’s organization.	The recipient’s admin.

These rules are in Microsoft’s anti-phishing documentation and external sender callouts announcement.

What’s next

Email deliverability for Agent Accounts: set up DMARC in stages
Set up domains for Agent Accounts: add TXT records at Cloudflare, Route 53, GoDaddy, or Namecheap
Using email signatures: create and manage HTML signatures
Message tracking: turn on open and link tracking with a custom hostname