Hubspot logo

Delete Contact (HubSpot)

HubSpot → Delete Contact (HubSpot)

POST/v1/hubspot-delete-contact
texau__hubspot-delete-contactcrm
Run in Studio →Open in MCP
cURL · api.texau.app
84ms
POST/v1/hubspot-delete-contact
{
  "contact_id": "sample-value"
}
200 Accepted
{
  "ok": true,
  "data": {
    "status": "valid"
  }
}

Delete a HubSpot contact record by its contact ID using the CRM v3 objects API.

Install

Add delete contact (hubspot) to your MCP client.

Drop this into claude_desktop_config.json (or your client's equivalent) and the tool shows up in any chat.

claude_desktop_config.json
{
  "mcpServers": {
    "texau": {
      "command": "npx",
      "args": ["-y", "@texau/mcp-server"],
      "env": { "TEXAU_API_KEY": "..." }
    }
  }
}

Tool name: texau__hubspot-delete-contact

When to use this.

The "Delete Contact (HubSpot)" action allows users to remove a specific contact record from HubSpot's CRM by utilizing the contact's unique ID through the CRM v3 objects API. This action requires a single input parameter, "contactId," which is a text field representing the unique identifier of the contact to be deleted. Upon execution, the action returns a boolean output field, "status," indicating the success or failure of the deletion process. This functionality is essential for maintaining accurate and up-to-date contact lists, making it particularly useful for businesses that need to manage their customer relationships effectively. The action falls under the CRM category, streamlining contact management tasks within HubSpot's ecosystem.

Try it

Run a sample request.

The response is a deterministic, cached example. No live call, no credits used.

Delete Contact (HubSpot)

Try it

The unique ID of the HubSpot contact to delete.

Response is cached — no live API call.

Response

Output schema.

Every field returned in `data`. Click rows to expand nested objects.

FieldType
  • status
    Status
    boolean

Integrate

Copy-pasteable snippets.

Real endpoint: https://v3-api.texau.com/api/v1/hubspot-delete-contact. Auth: x-api-key.

cURL · api.texau.app
84ms
POST/v1/hubspot-delete-contact
curl -X POST 'https://v3-api.texau.com/api/v1/hubspot-delete-contact' \
  -H 'x-api-key: $TEXAU_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"contact_id":"sample-value"}'
200 Accepted
{
  "ok": true,
  "data": {
    "status": "valid"
  }
}

Compose

How this fits a workflow.

The next 2 actions most operators chain after this one.

Delete Contact (HubSpot)→List Contacts (HubSpot)→Get Contact (HubSpot)

Output

Results land in a TexAu table.

Sample rows below.

Real result preview coming soon.

InputStatusScore
[email protected]valid96
[email protected]risky54
[email protected]invalid12

Workflow

A real example.

Trigger → delete contact (hubspot) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.

Step 1TriggerNew row, webhook, or schedule.
Step 2Delete Contact (HubSpot)HubSpot action runs.
Step 3EnrichWaterfall fills missing fields.
Step 4Push to CRMHubSpot / Salesforce / Pipedrive.

Built for

Who runs this.

GTM EngineerRevOpsAgency

Reliability

Rate limits & reliability.

  • Per-minute limit100 / min
  • Per-day limit24,000 / day
  • RetriesAutomatic w/ backoff
  • ModeSync

Errors

HTTP status codes.

What each response means and what to do about it.

CodeCauseFix
200 OKAction ran. Data in `data`.Read response.
400 Bad RequestMissing or malformed input.Validate against the input schema.
401 UnauthorizedMissing or invalid `x-api-key`.Re-issue from /api-platform.
403 ForbiddenWorkspace lacks plan tier.Upgrade or contact sales.
404 Not FoundAction key not recognized.Verify the slug.
429 Rate LimitedPer-minute or per-day cap hit.Backoff; reduce concurrency.
500 Server ErrorUnexpected TexAu issue.Retry with backoff.
502 Bad GatewayUpstream provider 5xx.Retry; we surface root cause.
504 TimeoutUpstream slower than maxLatency.Switch to `isAsync` polling.

Pricing

What it costs to run.

Light tier

Pricing tier on /pricing. Per-action credit cost is private.

Related

More HubSpot actions.

FAQ.

  • Is this real-time?

    Yes. Synchronous actions return in ~1–4 s. Long-running work uses async polling (see status 504 → switch to async).

  • Do I get charged on failure?

    No. Verified failures cost zero credits. Provider miss / 5xx / timeout cascade to the next provider in the waterfall when applicable.

  • Does it work with Claude / Cursor via MCP?

    Yes. Add the texau MCP server to your client config, then call `texau__hubspot-...` directly.

  • What CRMs can I push results to?

    HubSpot, Salesforce, Pipedrive, Zoho, and GoHighLevel are bidirectional. Smartlead, Instantly, Lemlist, HeyReach, Apollo Sequences, and Reply.io for outbound.

Run Delete Contact (HubSpot) in 60 seconds.

Pull your API key, paste the cURL, ship to your CRM.

Start free →Read the API docs