Delete a native contact

Removes the contact, after cancelling every booking it holds.

The bookings go first, and a delete that cannot cancel one is refused whole. Each booking is cancelled in the calendar that holds it, including a connected system such as Cal.com. A refusal comes back with failed naming the bookings that would not cancel, and, when some already went, cancelled naming those: they do not come back.

Send expectedAppointmentIds, taken from GET /api/native-contacts/{contactId}/delete-preview, once you have shown what will be cancelled. If the contact was booked again since, the delete is refused with 409 and nothing is cancelled.

This is not erasure. The number keeps its do-not-call decision, and a contact created later with that number inherits it.

Cookie-auth callers must send the x-csrf-token header.

Required API key scope: contacts:write.

DELETE

api

native-contacts

{contactId}

cURL

curl --request DELETE \
  --url https://api.teamfollowup.ai/api/native-contacts/{contactId} \
  --header 'Authorization: Bearer YOUR_API_KEY'

import requests

url = "https://api.teamfollowup.ai/api/native-contacts/{contactId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.teamfollowup.ai/api/native-contacts/{contactId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.teamfollowup.ai/api/native-contacts/{contactId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.teamfollowup.ai/api/native-contacts/{contactId}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.teamfollowup.ai/api/native-contacts/{contactId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "contactId": "nct_0123456789abcdef0123",
    "cancelled": [
      {
        "appointmentId": "apt_7d21c0f4a1",
        "calendarName": "Consultations",
        "startTime": "2026-09-24T15:00:00.000Z"
      }
    ],
    "removed": {
      "queue": 2,
      "appointments": 1
    }
  }
}

Authorizations

Authorization

string

header

required

Send your API key as Authorization: Bearer YOUR_API_KEY.

Path Parameters

contactId

string

required

The contact id.

Minimum string length: 1

Query Parameters

locationId

string

required

The sub-account these contacts belong to. Your access to it is checked on every call. A sub-account with a CRM answers 400.

Response

The contact is gone, with what was cancelled on the way.

success

boolean

required

data

object

required

Show child attributes

{key}

any

cURL

curl --request DELETE \
  --url https://api.teamfollowup.ai/api/native-contacts/{contactId} \
  --header 'Authorization: Bearer YOUR_API_KEY'

import requests

url = "https://api.teamfollowup.ai/api/native-contacts/{contactId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.teamfollowup.ai/api/native-contacts/{contactId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.teamfollowup.ai/api/native-contacts/{contactId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.teamfollowup.ai/api/native-contacts/{contactId}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.teamfollowup.ai/api/native-contacts/{contactId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "contactId": "nct_0123456789abcdef0123",
    "cancelled": [
      {
        "appointmentId": "apt_7d21c0f4a1",
        "calendarName": "Consultations",
        "startTime": "2026-09-24T15:00:00.000Z"
      }
    ],
    "removed": {
      "queue": 2,
      "appointments": 1
    }
  }
}

Developer setup

Agents

TFU Live

In-call Capabilities

Campaigns

Master agent

Phone Numbers

Caller ID

Voices

Projects

Calls

Contacts

Native Contacts

Native Calendar

Analytics

Billing

Delete a native contact

Authorizations

Path Parameters

Query Parameters

Response