Create a contact

Create a contact

curl --request POST \
  --url https://api-public.skipcall.app/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "John",
  "lastName": "Doe",
  "phoneNumbers": [
    "+33612345678"
  ],
  "email": "john.doe@example.com",
  "company": "Acme Inc.",
  "city": "Paris",
  "country": "France",
  "url": "https://example.com",
  "linkedinUrl": "https://linkedin.com/in/johndoe",
  "linkedinSalesUrl": "https://linkedin.com/sales/people/johndoe",
  "role": "CTO",
  "allowPhoneCalls": true,
  "customFields": {
    "industry": "Technology",
    "team_size": "50-100"
  }
}
'

import requests

url = "https://api-public.skipcall.app/v1/contacts"

payload = {
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumbers": ["+33612345678"],
    "email": "john.doe@example.com",
    "company": "Acme Inc.",
    "city": "Paris",
    "country": "France",
    "url": "https://example.com",
    "linkedinUrl": "https://linkedin.com/in/johndoe",
    "linkedinSalesUrl": "https://linkedin.com/sales/people/johndoe",
    "role": "CTO",
    "allowPhoneCalls": True,
    "customFields": {
        "industry": "Technology",
        "team_size": "50-100"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: 'John',
    lastName: 'Doe',
    phoneNumbers: ['+33612345678'],
    email: 'john.doe@example.com',
    company: 'Acme Inc.',
    city: 'Paris',
    country: 'France',
    url: 'https://example.com',
    linkedinUrl: 'https://linkedin.com/in/johndoe',
    linkedinSalesUrl: 'https://linkedin.com/sales/people/johndoe',
    role: 'CTO',
    allowPhoneCalls: true,
    customFields: {industry: 'Technology', team_size: '50-100'}
  })
};

fetch('https://api-public.skipcall.app/v1/contacts', 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-public.skipcall.app/v1/contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'firstName' => 'John',
    'lastName' => 'Doe',
    'phoneNumbers' => [
        '+33612345678'
    ],
    'email' => 'john.doe@example.com',
    'company' => 'Acme Inc.',
    'city' => 'Paris',
    'country' => 'France',
    'url' => 'https://example.com',
    'linkedinUrl' => 'https://linkedin.com/in/johndoe',
    'linkedinSalesUrl' => 'https://linkedin.com/sales/people/johndoe',
    'role' => 'CTO',
    'allowPhoneCalls' => true,
    'customFields' => [
        'industry' => 'Technology',
        'team_size' => '50-100'
    ]
  ]),
  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-public.skipcall.app/v1/contacts"

	payload := strings.NewReader("{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"phoneNumbers\": [\n    \"+33612345678\"\n  ],\n  \"email\": \"john.doe@example.com\",\n  \"company\": \"Acme Inc.\",\n  \"city\": \"Paris\",\n  \"country\": \"France\",\n  \"url\": \"https://example.com\",\n  \"linkedinUrl\": \"https://linkedin.com/in/johndoe\",\n  \"linkedinSalesUrl\": \"https://linkedin.com/sales/people/johndoe\",\n  \"role\": \"CTO\",\n  \"allowPhoneCalls\": true,\n  \"customFields\": {\n    \"industry\": \"Technology\",\n    \"team_size\": \"50-100\"\n  }\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api-public.skipcall.app/v1/contacts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"phoneNumbers\": [\n    \"+33612345678\"\n  ],\n  \"email\": \"john.doe@example.com\",\n  \"company\": \"Acme Inc.\",\n  \"city\": \"Paris\",\n  \"country\": \"France\",\n  \"url\": \"https://example.com\",\n  \"linkedinUrl\": \"https://linkedin.com/in/johndoe\",\n  \"linkedinSalesUrl\": \"https://linkedin.com/sales/people/johndoe\",\n  \"role\": \"CTO\",\n  \"allowPhoneCalls\": true,\n  \"customFields\": {\n    \"industry\": \"Technology\",\n    \"team_size\": \"50-100\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-public.skipcall.app/v1/contacts")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"phoneNumbers\": [\n    \"+33612345678\"\n  ],\n  \"email\": \"john.doe@example.com\",\n  \"company\": \"Acme Inc.\",\n  \"city\": \"Paris\",\n  \"country\": \"France\",\n  \"url\": \"https://example.com\",\n  \"linkedinUrl\": \"https://linkedin.com/in/johndoe\",\n  \"linkedinSalesUrl\": \"https://linkedin.com/sales/people/johndoe\",\n  \"role\": \"CTO\",\n  \"allowPhoneCalls\": true,\n  \"customFields\": {\n    \"industry\": \"Technology\",\n    \"team_size\": \"50-100\"\n  }\n}"

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

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "firstName": "John",
  "lastName": "Doe",
  "allowPhoneCalls": true,
  "callCount": 5,
  "teamId": "550e8400-e29b-41d4-a716-446655440000",
  "phoneNumbers": [
    "+33612345678"
  ],
  "customFields": {
    "Industry": "Technology",
    "Size": "50-100"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "email": "john.doe@example.com",
  "company": "Acme Inc.",
  "city": "Paris",
  "country": "France",
  "url": "https://example.com",
  "linkedinUrl": "https://linkedin.com/in/johndoe",
  "linkedinSalesUrl": "https://linkedin.com/sales/people/johndoe",
  "role": "CTO",
  "lastCallAt": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or revoked API key",
    "status": 401
  }
}

{
  "error": {
    "code": "PLAN_NOT_ELIGIBLE",
    "message": "API access requires INTERMÉDIAIRE or EXPERT plan",
    "status": 403
  }
}

POST

contacts

Create a contact

curl --request POST \
  --url https://api-public.skipcall.app/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "John",
  "lastName": "Doe",
  "phoneNumbers": [
    "+33612345678"
  ],
  "email": "john.doe@example.com",
  "company": "Acme Inc.",
  "city": "Paris",
  "country": "France",
  "url": "https://example.com",
  "linkedinUrl": "https://linkedin.com/in/johndoe",
  "linkedinSalesUrl": "https://linkedin.com/sales/people/johndoe",
  "role": "CTO",
  "allowPhoneCalls": true,
  "customFields": {
    "industry": "Technology",
    "team_size": "50-100"
  }
}
'

import requests

url = "https://api-public.skipcall.app/v1/contacts"

payload = {
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumbers": ["+33612345678"],
    "email": "john.doe@example.com",
    "company": "Acme Inc.",
    "city": "Paris",
    "country": "France",
    "url": "https://example.com",
    "linkedinUrl": "https://linkedin.com/in/johndoe",
    "linkedinSalesUrl": "https://linkedin.com/sales/people/johndoe",
    "role": "CTO",
    "allowPhoneCalls": True,
    "customFields": {
        "industry": "Technology",
        "team_size": "50-100"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: 'John',
    lastName: 'Doe',
    phoneNumbers: ['+33612345678'],
    email: 'john.doe@example.com',
    company: 'Acme Inc.',
    city: 'Paris',
    country: 'France',
    url: 'https://example.com',
    linkedinUrl: 'https://linkedin.com/in/johndoe',
    linkedinSalesUrl: 'https://linkedin.com/sales/people/johndoe',
    role: 'CTO',
    allowPhoneCalls: true,
    customFields: {industry: 'Technology', team_size: '50-100'}
  })
};

fetch('https://api-public.skipcall.app/v1/contacts', 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-public.skipcall.app/v1/contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'firstName' => 'John',
    'lastName' => 'Doe',
    'phoneNumbers' => [
        '+33612345678'
    ],
    'email' => 'john.doe@example.com',
    'company' => 'Acme Inc.',
    'city' => 'Paris',
    'country' => 'France',
    'url' => 'https://example.com',
    'linkedinUrl' => 'https://linkedin.com/in/johndoe',
    'linkedinSalesUrl' => 'https://linkedin.com/sales/people/johndoe',
    'role' => 'CTO',
    'allowPhoneCalls' => true,
    'customFields' => [
        'industry' => 'Technology',
        'team_size' => '50-100'
    ]
  ]),
  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-public.skipcall.app/v1/contacts"

	payload := strings.NewReader("{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"phoneNumbers\": [\n    \"+33612345678\"\n  ],\n  \"email\": \"john.doe@example.com\",\n  \"company\": \"Acme Inc.\",\n  \"city\": \"Paris\",\n  \"country\": \"France\",\n  \"url\": \"https://example.com\",\n  \"linkedinUrl\": \"https://linkedin.com/in/johndoe\",\n  \"linkedinSalesUrl\": \"https://linkedin.com/sales/people/johndoe\",\n  \"role\": \"CTO\",\n  \"allowPhoneCalls\": true,\n  \"customFields\": {\n    \"industry\": \"Technology\",\n    \"team_size\": \"50-100\"\n  }\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api-public.skipcall.app/v1/contacts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"phoneNumbers\": [\n    \"+33612345678\"\n  ],\n  \"email\": \"john.doe@example.com\",\n  \"company\": \"Acme Inc.\",\n  \"city\": \"Paris\",\n  \"country\": \"France\",\n  \"url\": \"https://example.com\",\n  \"linkedinUrl\": \"https://linkedin.com/in/johndoe\",\n  \"linkedinSalesUrl\": \"https://linkedin.com/sales/people/johndoe\",\n  \"role\": \"CTO\",\n  \"allowPhoneCalls\": true,\n  \"customFields\": {\n    \"industry\": \"Technology\",\n    \"team_size\": \"50-100\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-public.skipcall.app/v1/contacts")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"phoneNumbers\": [\n    \"+33612345678\"\n  ],\n  \"email\": \"john.doe@example.com\",\n  \"company\": \"Acme Inc.\",\n  \"city\": \"Paris\",\n  \"country\": \"France\",\n  \"url\": \"https://example.com\",\n  \"linkedinUrl\": \"https://linkedin.com/in/johndoe\",\n  \"linkedinSalesUrl\": \"https://linkedin.com/sales/people/johndoe\",\n  \"role\": \"CTO\",\n  \"allowPhoneCalls\": true,\n  \"customFields\": {\n    \"industry\": \"Technology\",\n    \"team_size\": \"50-100\"\n  }\n}"

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

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "firstName": "John",
  "lastName": "Doe",
  "allowPhoneCalls": true,
  "callCount": 5,
  "teamId": "550e8400-e29b-41d4-a716-446655440000",
  "phoneNumbers": [
    "+33612345678"
  ],
  "customFields": {
    "Industry": "Technology",
    "Size": "50-100"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "email": "john.doe@example.com",
  "company": "Acme Inc.",
  "city": "Paris",
  "country": "France",
  "url": "https://example.com",
  "linkedinUrl": "https://linkedin.com/in/johndoe",
  "linkedinSalesUrl": "https://linkedin.com/sales/people/johndoe",
  "role": "CTO",
  "lastCallAt": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or revoked API key",
    "status": 401
  }
}

{
  "error": {
    "code": "PLAN_NOT_ELIGIBLE",
    "message": "API access requires INTERMÉDIAIRE or EXPERT plan",
    "status": 403
  }
}

Authorizations

Authorization

string

header

required

Enter your API Key (sk_live_xxx or sk_test_xxx)

Headers

x-workspace-id

string<uuid>

Target workspace id (from GET /v1/workspaces). Required for multi-workspace API keys to designate which workspace to write to; omit for single-workspace keys, where it is resolved automatically. Must be within the API key scope.

Body

application/json

firstName

string

required

First name of the contact

Required string length: 1 - 100

Example:

"John"

lastName

string

required

Last name of the contact

Required string length: 1 - 100

Example:

"Doe"

phoneNumbers

string[]

required

Phone numbers in E.164 format (e.g., +33612345678)

Required array length: 1 - 20 elements

Example:

["+33612345678"]

string

Email address of the contact

Example:

"john.doe@example.com"

company

string

Company name

Maximum string length: 200

Example:

"Acme Inc."

city

string

City

Maximum string length: 200

Example:

"Paris"

country

string

Country

Maximum string length: 200

Example:

"France"

url

string

Website URL

Example:

"https://example.com"

linkedinUrl

string

LinkedIn profile URL

Example:

"https://linkedin.com/in/johndoe"

linkedinSalesUrl

string

LinkedIn Sales Navigator URL

Example:

"https://linkedin.com/sales/people/johndoe"

role

string

Role / job title

Maximum string length: 200

Example:

"CTO"

allowPhoneCalls

boolean

Whether the contact accepts phone calls. Defaults to true.

Example:

true

customFields

object

Custom field values keyed by the custom field slug (the stable, immutable identifier returned by GET /custom-fields). Custom fields must already exist for the team (use the Custom Fields endpoints to create them). For backwards compatibility this endpoint also accepts keys matching the custom field name, but this fallback is deprecated and will be removed in a future release — migrate your integrations to use slugs.

Show child attributes

Example:

{
  "industry": "Technology",
  "team_size": "50-100"
}

Response

The created contact

string

required

Example:

"550e8400-e29b-41d4-a716-446655440000"

firstName

string

required

Example:

"John"

lastName

string

required

Example:

"Doe"

allowPhoneCalls

boolean

required

Example:

true

callCount

number

required

Example:

5

teamId

string

required

Example:

"550e8400-e29b-41d4-a716-446655440000"

phoneNumbers

string[]

required

Example:

["+33612345678"]

customFields

object

required

Show child attributes

Example:

{
  "Industry": "Technology",
  "Size": "50-100"
}

createdAt

string<date-time>

required

updatedAt

string<date-time>

required

lastModificationSource

enum<string>

required

Available options:

SKIPCALL,

API

object | null

Example:

"john.doe@example.com"

company

object | null

Example:

"Acme Inc."

city

object | null

Example:

"Paris"

country

object | null

Example:

"France"

url

object | null

Example:

"https://example.com"

linkedinUrl

object | null

Example:

"https://linkedin.com/in/johndoe"

linkedinSalesUrl

object | null

Example:

"https://linkedin.com/sales/people/johndoe"

role

object | null

Example:

"CTO"

lastCallAt

string<date-time> | null

List contacts Get a contact

Get started

Available endpoints

Authorizations

Headers

Body

Response