Skip to content
UpSmith Help Center home
InboxAsk a human

Angi Leads

Updated by spencer@upsmith.com

In this article

In this article group

Bring your Angi leads straight into UpSmith so your AI agent answers them automatically. Angi delivers leads over a secure webhook that's unique to your account. Setup is self-serve in UpSmith, with one coordination step: you send Angi your connection details so they can register the endpoint before leads start arriving.

Before you begin

An active Lenny agent with a channel linked to him. Lenny is the agent that answers new leads, and he answers them for every source — there's no separate agent to pick here. You'll find him under Agents.

Without him, Connect opens a dialog instead of connecting: "Assign a lead responder first — No active Lenny agent is set up to answer new leads. Connecting this source now would drop every lead it brings in. Set up Lenny in Agents, then connect." If he's there but has no channel, you'll get "Your lead responder has no channel" instead. Either way the dialog offers you Open Lenny to go and fix it.

  • Your Angi Company IDs (SPIDs) — one or more, from your Angi account.

  • A contact email (and a CRM key only if Angi or your CRM specifically asks for one).

The Angi card is available to every account on the Integrations page — there's nothing to switch on first.

Step by step

  1. Make sure Lenny is ready. Under Agents, Lenny should be active with a channel linked — see Before you begin.

  2. Configure the connection. Open the Angi card → Connect → Setup Angi, and fill in:

    • SPIDs — one entry per Angi company ID (blank entries are ignored).

    • Contact email & CRM key — the email Angi should use; leave CRM key blank unless it's explicitly requested.

    • Environment — choose Test while validating, or Production for live leads.

    Click Create connection — it's created in Pending status.

  3. Copy the webhook URL and API key. UpSmith reveals both in a credentials window. The API key is shown only once — copy and store both securely before closing. If the key is ever lost, use Rotate key on the card to generate a new one, then resend it to Angi.

  4. Send the credentials to Angi. Email crmintegrations@angi.com and ask them to configure the production endpoint for the Leads API webhook. Include your Angi Company ID(s)/SPIDs, the webhook URL, the API key, your contact email, and a CRM key if you use one. (UpSmith's "How it works" window pre-fills a suggested message you can copy.)

  5. Activate. Once Angi confirms the endpoint is set up, return to the Angi card and click Activate. If anything's still missing, UpSmith tells you what (e.g. missing API key, or a missing campaign — see Turning it on). After activation the status flips to Connected, and incoming Angi leads flow into UpSmith; Lenny starts replying to them once we've switched the campaign on (see Turning it on).

Turning it on

Connecting isn't the last step, and the order matters here more than on other sources.

  1. Connect, and finish the setup steps above.

  2. Email support@upsmith.com before you touch Activate. Angi needs a lead-response campaign and it isn't created automatically. We'll set it up and switch it on.

  3. Then click Activate. It'll go through once the campaign is there.

If you press Activate first, it will refuse — "Campaign missing: Angi has no lead-response campaign yet." That isn't something you've done wrong and it isn't a fault. It's the same missing piece, and the same email fixes it.

Connection states & controls

  • Pending — created, awaiting activation. Connected — live. Paused — processing stopped without deleting the connection. Needs attention — something needs a look.

  • Edit setup — update SPIDs, contact email, CRM key, or environment anytime.

  • Rotate key — generate a fresh API key (shown once); send the new key to Angi to keep delivery working.

  • Pause / Resume — pause stops processing without deleting the connection; resume re-enables it instantly.

  • Last webhook received — a timestamp of the most recent lead, so you can confirm at a glance that leads are arriving.

Onboarding checklist

  • Lenny active with a channel linked

  • Connection configured with SPIDs, contact email, and environment

  • Webhook URL and API key copied and stored securely

  • Credentials emailed to crmintegrations@angi.com and endpoint confirmed by Angi

  • Connection activated and showing Connected; first webhook received

  • Campaign switched on by UpSmith; first lead answered

Where to go next

Need help? Email UpSmith support at support@upsmith.com.