cURL

curl --request DELETE \
  --url https://api.teamfollowup.ai/api/contacts/internal \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "locationId": "loc_abc123",
  "contactId": "contact_123",
  "phoneNumber": "+15551234567"
}'

import requests

url = "https://api.teamfollowup.ai/api/contacts/internal"

payload = {
    "locationId": "loc_abc123",
    "contactId": "contact_123",
    "phoneNumber": "+15551234567"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'DELETE',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    locationId: 'loc_abc123',
    contactId: 'contact_123',
    phoneNumber: '+15551234567'
  })
};

fetch('https://api.teamfollowup.ai/api/contacts/internal', 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/contacts/internal",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'locationId' => 'loc_abc123',
    'contactId' => 'contact_123',
    'phoneNumber' => '+15551234567'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.teamfollowup.ai/api/contacts/internal"

	payload := strings.NewReader("{\n  \"locationId\": \"loc_abc123\",\n  \"contactId\": \"contact_123\",\n  \"phoneNumber\": \"+15551234567\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.teamfollowup.ai/api/contacts/internal")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"locationId\": \"loc_abc123\",\n  \"contactId\": \"contact_123\",\n  \"phoneNumber\": \"+15551234567\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.teamfollowup.ai/api/contacts/internal")

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

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"locationId\": \"loc_abc123\",\n  \"contactId\": \"contact_123\",\n  \"phoneNumber\": \"+15551234567\"\n}"

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

{
  "success": true,
  "data": {
    "contactId": "contact_123",
    "phoneNumber": "+15551234567",
    "locationId": "loc_abc123",
    "projectName": "Acme Clinic",
    "isInternal": false,
    "matched": 3,
    "changed": true
  }
}

{
  "success": false,
  "error": "projectName is required"
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "Access denied to this project"
}

{
  "success": false,
  "error": "Project not found or not configured for CRM integration"
}

{
  "success": false,
  "error": "TooManyRequests"
}

{
  "success": false,
  "error": "Unexpected server error."
}

Clear contact internal mark

Authentication required. Intended for customer-facing agency administrators and project users. Results and actions are tenant-scoped to projects visible to the caller.

Clears the internal mark, putting the contact’s calls back into the dashboard figures. Applies retroactively to the whole call history, not only to calls from here on.

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

Required API key scope: contacts:write.

DELETE

api

contacts

internal

cURL

curl --request DELETE \
  --url https://api.teamfollowup.ai/api/contacts/internal \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "locationId": "loc_abc123",
  "contactId": "contact_123",
  "phoneNumber": "+15551234567"
}'

import requests

url = "https://api.teamfollowup.ai/api/contacts/internal"

payload = {
    "locationId": "loc_abc123",
    "contactId": "contact_123",
    "phoneNumber": "+15551234567"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'DELETE',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    locationId: 'loc_abc123',
    contactId: 'contact_123',
    phoneNumber: '+15551234567'
  })
};

fetch('https://api.teamfollowup.ai/api/contacts/internal', 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/contacts/internal",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'locationId' => 'loc_abc123',
    'contactId' => 'contact_123',
    'phoneNumber' => '+15551234567'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.teamfollowup.ai/api/contacts/internal"

	payload := strings.NewReader("{\n  \"locationId\": \"loc_abc123\",\n  \"contactId\": \"contact_123\",\n  \"phoneNumber\": \"+15551234567\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.teamfollowup.ai/api/contacts/internal")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"locationId\": \"loc_abc123\",\n  \"contactId\": \"contact_123\",\n  \"phoneNumber\": \"+15551234567\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.teamfollowup.ai/api/contacts/internal")

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

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"locationId\": \"loc_abc123\",\n  \"contactId\": \"contact_123\",\n  \"phoneNumber\": \"+15551234567\"\n}"

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

{
  "success": true,
  "data": {
    "contactId": "contact_123",
    "phoneNumber": "+15551234567",
    "locationId": "loc_abc123",
    "projectName": "Acme Clinic",
    "isInternal": false,
    "matched": 3,
    "changed": true
  }
}

{
  "success": false,
  "error": "projectName is required"
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "Access denied to this project"
}

{
  "success": false,
  "error": "Project not found or not configured for CRM integration"
}

{
  "success": false,
  "error": "TooManyRequests"
}

{
  "success": false,
  "error": "Unexpected server error."
}

Authorizations

Authorization

string

header

required

Send your API key as Authorization: Bearer YOUR_API_KEY.

Body

application/json

The project, and the contact identified by id or phone number.

Option 1
Option 2

Identify the contact by contactId, by phoneNumber, or by both. At least one is required. Around 2% of contacts carry no id and are reachable only by number.

locationId

string

required

Stable project location id used to tenant-scope the contact action.

Minimum string length: 1

Example:

"loc_abc123"

contactId

string

required

Stable contact id. Preferred when the contact has one.

Example:

"contact_123"

projectName

string

Optional display label. Never used as tenant identity.

Example:

"Acme Clinic"

phoneNumber

string

Contact phone number. Required when the contact has no id, and worth sending alongside one to reach records written before that id existed.

Example:

"+15551234567"

Response

Internal mark cleared successfully.

success

boolean

required

data

object

required

Show child attributes

Agents

Skills & Tools

Campaigns

Campaign Workflows

Calls

Analytics

Projects

Power Dialer

Contacts

Phone Numbers

Voices

GHL

Clear contact internal mark

Authorizations

Body

Response