# purchase_outreach_domains (/docs/mcp/tools/purchase-outreach-domains)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/purchase_outreach_domains.mdx. */}

**Buy outreach domains** · Deletes or overwrites data · Acts outside your account · Spends credits or money

Buy every domain in the website's picked list (added with add_outreach_domain) and set each one up for outreach: registration, DNS, SPF/DKIM/DMARC, a mailbox and warmup. This charges the card immediately for the first year of each domain, and each mailbox is then billed as a monthly subscription. Confirm the domains and the total with the user before calling. Setup runs in the background and the user is emailed when it is done; follow it with get_domain_setup_status. By default each domain gets one mailbox named firstname.lastname from emailSenderInfo. Errors: no domains picked, missing sender info, payment_method_required, or HTTP 402 when the payment fails. Returns success, a message and outreachDomains[]. Not available with a website-scoped key.

| Connection | Account-owner URL or OAuth (not a team member URL) |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `websiteId` | `string` | Yes | Website id from list_websites whose picked domains are bought. |
| `domains` | `any[]` | Yes | Not used to choose domains: the purchase always covers every domain currently picked for the website. Use add_outreach_domain / remove_outreach_domain to change the selection. |
| `paymentMethodId` | `string` | No | Id of the saved payment card to charge. Required unless a coupon makes the order free. |
| `emailSenderInfo` | `object` | No | Sender details for the new mailboxes: \{ firstName, lastName, jobTitle \}, all three required. |
| `couponCode` | `string` | No | Optional coupon code for the order. |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "purchase_outreach_domains",
  "title": "Buy outreach domains",
  "annotations": {
    "title": "Buy outreach domains",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": true
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website id from list_websites whose picked domains are bought."
      },
      "domains": {
        "type": "array",
        "description": "Not used to choose domains: the purchase always covers every domain currently picked for the website. Use add_outreach_domain / remove_outreach_domain to change the selection."
      },
      "paymentMethodId": {
        "type": "string",
        "description": "Id of the saved payment card to charge. Required unless a coupon makes the order free."
      },
      "emailSenderInfo": {
        "type": "object",
        "description": "Sender details for the new mailboxes: { firstName, lastName, jobTitle }, all three required."
      },
      "couponCode": {
        "type": "string",
        "description": "Optional coupon code for the order."
      }
    },
    "required": [
      "websiteId",
      "domains"
    ]
  }
}
```