Get a snoozed contact by LinkedIn username

curl --request GET \
  --url https://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username} \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username}"

headers = {"x-api-key": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username}', 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://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username}"

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

	req.Header.Add("x-api-key", "<api-key>")

	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://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username}")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

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

{
  "_id": "66f2b7d1c3a4e5f6a7b8c9d0",
  "team": "64f1a2b3c4d5e6f7a8b9c0d1",
  "phone_number": "+14155552671",
  "snooze_until": "2026-11-02T15:00:00.000Z",
  "user": {
    "_id": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>"
  },
  "contact_list": "6650c1f2a4b8e93d2c1f0a10",
  "linkedin_username": "jane-doe-4b21a3",
  "external_contact_id": "0035e00000AbCdEfGh",
  "email": "[email protected]",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Snoozed contact not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Snoozed contacts

Get a snoozed contact by LinkedIn username

Returns the snooze record for a LinkedIn username, such as jane-doe-4b21a3 from linkedin.com/in/jane-doe-4b21a3. Pass the username alone, not the profile URL. The match is exact and case-sensitive. If several records share the username, one of them is returned.

Expired records are returned too: compare snooze_until with the current time. To check other identifiers, use GET /v1/snoozed-contacts with its filters.

GET

snoozed-contacts

by-linkedin

{username}

Get a snoozed contact by LinkedIn username

curl --request GET \
  --url https://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username} \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username}"

headers = {"x-api-key": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username}', 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://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username}"

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

	req.Header.Add("x-api-key", "<api-key>")

	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://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/{username}")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

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

{
  "_id": "66f2b7d1c3a4e5f6a7b8c9d0",
  "team": "64f1a2b3c4d5e6f7a8b9c0d1",
  "phone_number": "+14155552671",
  "snooze_until": "2026-11-02T15:00:00.000Z",
  "user": {
    "_id": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>"
  },
  "contact_list": "6650c1f2a4b8e93d2c1f0a10",
  "linkedin_username": "jane-doe-4b21a3",
  "external_contact_id": "0035e00000AbCdEfGh",
  "email": "[email protected]",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Snoozed contact not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Returns the snooze record for a LinkedIn username. Use it to check whether a person is snoozed before you call them or add them to a list. The username is the part of the profile URL after linkedin.com/in/: for https://www.linkedin.com/in/jane-doe-4b21a3 it is jane-doe-4b21a3. Pass the username alone, not the URL.

Example

curl https://client-api.salesfinity.co/v1/snoozed-contacts/by-linkedin/jane-doe-4b21a3 \
  --header 'x-api-key: YOUR_API_KEY'

Response (200):

{
  "_id": "66f2b7d1c3a4e5f6a7b8c9d0",
  "team": "64f1a2b3c4d5e6f7a8b9c0d1",
  "user": {
    "_id": "680edc0d1504192884a148e0",
    "first_name": "Sam",
    "last_name": "Rivera",
    "email": "[email protected]"
  },
  "linkedin_username": "jane-doe-4b21a3",
  "external_contact_id": "0035e00000AbCdEfGh",
  "email": "[email protected]",
  "phone_number": "+14155552671",
  "snooze_until": "2026-11-02T15:00:00.000Z",
  "createdAt": "2026-10-03T14:12:09.330Z",
  "updatedAt": "2026-10-03T14:12:09.330Z"
}

_id is the ID that Get a snoozed contact, Update a snoozed contact and Delete a snoozed contact take.

Matching

The match is exact and case-sensitive.
If several records share the username, one of them is returned.
Expired records are returned too. The person is snoozed only while snooze_until is later than now.
To check by email, phone number or CRM ID instead, use List snoozed contacts with its filters.

Errors

Status	When
404	No snooze record with this LinkedIn username in your team (`Snoozed contact not found`).

Authorizations

x-api-key

string

header

required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Path Parameters

username

string

required

LinkedIn username: the part of the profile URL after linkedin.com/in/. Exact, case-sensitive match.

Example:

"jane-doe-4b21a3"

Response

Found. The body is the snooze record.

_id

string

required

ID of the snooze record.

Example:

"66f2b7d1c3a4e5f6a7b8c9d0"

team

string

required

ID of your team. GET /v1/snoozed-contacts currently returns a new random value here.

Example:

"64f1a2b3c4d5e6f7a8b9c0d1"

phone_number

string

required

The number that was called when the snooze was set while logging a call, or the contact's first number when snoozed from the contact table. Can be empty.

Example:

"+14155552671"

snooze_until

string<date-time>

required

When the snooze ends. The record is kept after this time.

Example:

"2026-11-02T15:00:00.000Z"

user

object

Show child attributes

contact_list

string

ID of the dialing queue the contact was snoozed from. Present only when a rep snoozed contacts from the dialer's contact table; absent when the snooze was set while logging a call. GET /v1/snoozed-contacts currently returns a new random value here.

Example:

"6650c1f2a4b8e93d2c1f0a10"

linkedin_username

string

LinkedIn username: the part of the profile URL after linkedin.com/in/.

Example:

"jane-doe-4b21a3"

external_contact_id

string

The contact's ID in your CRM.

Example:

"0035e00000AbCdEfGh"

string

Email address.

Example:

"[email protected]"

createdAt

string<date-time>

updatedAt

string<date-time>

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

Get a snoozed contact by LinkedIn username

Example

Matching

Errors

Authorizations

Path Parameters

Response

​Example

​Matching

​Errors

Authorizations

Path Parameters

Response

Example

Matching

Errors