Twain integration

Twain researches each contact, writes their sequence from one of your Twain campaigns, and adds them to that campaign as a lead. There's no prompt to write: map your contact columns and add a signal, like a job change or company news, to tell Twain why you're reaching out right now.

Choose how much research Twain does on each contact: Base is the fastest, High adds a qualification thesis, and Ultra goes deepest and adds an outreach strategy.

Enriching data with Twain

1. While in a Clay table, click Add enrichment and search for Twain.
2. Under Integrations, select Deep research and outreach copy.
3. In the modal, you will be asked to Select Twain V3 account.
   • To bill runs to your own Twain account, click + Add account and enter your Twain API key, which Clay lists as a Twain V3 API Key account. Otherwise, use the Clay provided key, which uses your Clay credits instead.

Action Deep research and outreach copy

Research a contact and generate a personalized outreach sequence from one of your Twain campaigns.

Inputs

Required:

• Generation mode: How much research and reasoning Twain spends on each contact.
  • Base: Minimal research, and the fastest option.
  • High: The standard research depth.
  • Ultra: The deepest research, with written reasoning that guides how each step is planned. It takes several minutes per contact.
• Campaign: The Twain campaign to generate the sequence for. With your own Twain account connected, this is a dropdown of the campaigns in that account. With the Clay provided key, it's a Campaign ID field instead: in Twain, open the ... menu next to the campaign and click Copy ID.
• Contact professional profile URL: The contact's profile URL, which gives more granular results than an email. (Required if Contact email address is not provided.)
• Contact email address: The contact's work email address. (Required if the professional profile URL is not provided.)

Optional:

• Add lead to campaign: Adds the contact to the campaign as a lead in Twain. On by default. Turn it off to generate a sequence without adding the contact to the campaign.
• Contact name: The contact's name.
• Contact company domain: The contact's company domain.
• Contact trigger / signal: Why you're reaching out to this contact right now (e.g., "Posted a job ad to hire GTM engineers for their team.").
• Custom variable 1–10: Up to 10 extra details to pass to Twain for the contact. Each one has three fields:
  • Name: The variable's name.
  • Value: The variable's value. This can come from a column, so each row sends its own value.
  • Description: What the variable holds.

Outputs

Twain generates in the background, so the cell first shows that generation has started, then fills in with the results when Twain finishes. What comes back depends on the generation mode:

• Base: A personalized sequence, with one message for each step in your campaign.
• High: The sequence, plus a qualification thesis for the contact.
• Ultra: The sequence, plus a thesis and an outreach strategy.

Run settings

• Auto-update: Useful when contacts keep arriving, so each new row gets a sequence without re-running the column. With Add lead to campaign on, those contacts are also added to your Twain campaign as they land.
• Only run if: The enrichment will only run if conditions are met. (Learn more about conditional formulas here!)

FAQs

Does Clay charge credits if I use my own Twain API key?

With your own Twain API key, Clay doesn't charge credits for this action, and Twain bills your Twain account instead.

Can I use a different generation mode for each row?

Yes. Click the gear button beside Generation mode, switch the input to Text with tokens, and map a column holding Base, High, or Ultra for each row. Rows with an empty or unrecognized value fail and ask you to select a generation mode.

What happens to Twain columns set up before Base, High, and Ultra?

They keep running the way they were set up.

To move a column onto the new modes, pick one under Generation mode. If the column runs (DEPRECATED) Generate outreach with deep research, it has no generation modes, so add a new Deep research and outreach copy enrichment instead.