Customers and access

Deactivate external customer

View as Markdown Raw markdown in a new tab Open in ChatGPT Ask questions about this page Open in Claude Ask questions about this page

POST / v1 / customers / {customer_id} / pause

Deactivates an external customer: imported or granted, and never bought a paid product (imported is true in GET /v1/customers/{customer_id}).

The customer loses access to all products and gets no emails.
They no longer count toward the external customers of the plan.
Their data and progress stay.
Waiting campaign and automation emails for the customer are dropped for good.

To undo it, use POST /v1/customers/{customer_id}/resume.

After the call: the account owner confirms at the confirm_url within 5 minutes. Then check the result with GET /v1/confirmations/{confirmation_id}.

Needs your confirmation MCP tool pause_customer

Changes nothing at once. The answer has a link that the account owner confirms in Tentary. Confirmations

curl -X POST "https://api.tentary.com/v1/customers/404/pause" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

const response = await fetch("https://api.tentary.com/v1/customers/404/pause", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/customers/404/pause",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/customers/404/pause');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "status": "needs_confirmation",
  "confirmation_id": 1,
  "confirm_url": "https://app.tentary.com/ai/confirm/INDmTwfH4gHEFrefS0ZO4ilsj3xkpPn8",
  "expires_at": "2026-10-27T08:56:48Z",
  "summary": "Deactivate customer [email protected]",
  "message": "Nothing happened yet. Give the seller the confirm_url: they open it while logged in to Tentary and confirm within 5 minutes. Then call get_confirmation to see the result. If the link expired, call this tool again."
}

Authorization

Authorization string header required

Bearer tnt_… · A personal API key (tnt_...). Create it in the Tentary app on the page AI & API. Introduction

Path parameters

customer_id integer required

The id from search_customers or get_customer.

min 1 Example: 404

Response

Fields of the answer with status 200. Errors always have the same format, see Errors.

The action waits for the seller's confirmation.

status string

Nothing happened yet.

Allowed values: needs_confirmation
confirmation_id integer

For get_confirmation.
confirm_url string<uri>

The seller opens it while logged in to Tentary and confirms.
expires_at string<date-time>

UTC, like 2026-01-31T14:05:00Z. The link works until then.
summary string

What the seller confirms.
message string

Next steps for the AI app.