Level up your welcome emails with our new Role attribute

Level up your welcome emails with our new Role attribute

January 28, 2016

Every SaaS app in the world sends out welcome emails. Some are awesome, some are not. Last spring we reached the point where we could no longer manually send customized welcome emails. However, we really didn't like the idea of sending the same bland generic email to all of our new users. We have three distinct user types (engineering, marketing, and sales), and using the same language and call to action seemed like such a waste.

Luckily we found a solution in our own data. We built a relatively complex set of rules that looked for keywords in the Enrichment results for each new user. For example: If alex@clearbit.com signed up, we would look at his title, bio and social handles. If any of these fields contained one of the 70 keywords or patterns in our engineering rules, we would categorize Alex and send him our engineering welcome email vs. the sales or marketing focused ones.

Then we thought, why not standardize this and bake it into our APIs for everyone to use? With our recent addition of Role and Seniority to our Enrichment APIs we've done exactly that, taking that keyword recognition & pattern analysis, baking it right into the API response.

Here's how it works: send us an email address and we'll include a standardized role and seniority attributes in the JSON response. Here's a full list of the mappings.

  "email": "rob@clearbit.com"
  "name": {
    "fullName": "Rob Holland",
    "givenName": "Rob",
    "familyName": "Holland"
  "employment": {
    "domain": "clearbit.com",
    "name": "Clearbit",
    "title": "Developer at Clearbit",
    "role": "engineering",
    "seniority": "executive"
  // ...

When we see a signup with role=engineering we make sure our initial communication is developer focused and optimized for making the first API call.

Conversely, when we see signups from role=sales or role=marketing we've found a majority of the questions arise around our integrations and productivity tools. In this case our email comes with some great sales/marketing use-cases and then offers a quick voice or video chat (if they're into that kind of thing).

All of this is handled with a few simple rules set up in Customer.io.

To see this in action on your account, first make sure your API keys are up to date here then go ahead and make a few calls!

How to create an ideal customer profile for B2B leads (+templates)

Marketing & Growthby Jess Cody on March 10, 2023

Establishing an ICP is crucial for effective outreach. Learn about ICPs and download some ideal customer profile templates with our comprehensive guide.

The ultimate guide to marketing qualified leads (MQLs)

Marketing & Growthby Alex Ross on March 07, 2023

A marketing qualified lead is an individual who has been identified as more likely to buy. Learn how to identify this important prospect with our guide on MQLs.

Join our newsletter

Engaging stories and exclusive data, designed for our best customers. One useful issue each month.