GET

api

account-suggestions

List Account Suggestions

curl --request GET \
  --url https://api.sequenzy.com/api/v1/account-suggestions \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.sequenzy.com/api/v1/account-suggestions', 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.sequenzy.com/api/v1/account-suggestions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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.sequenzy.com/api/v1/account-suggestions"

	req, _ := http.NewRequest("GET", 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.sequenzy.com/api/v1/account-suggestions")

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

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

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

{
  "success": true,
  "suggestions": [
    {
      "domain": "acme.com",
      "name": "Acme",
      "contactCount": 7,
      "sampleEmails": ["ana@acme.com", "ben@acme.com", "chris@acme.com"]
    },
    {
      "domain": "globex.io",
      "name": "Globex",
      "contactCount": 4,
      "sampleEmails": ["dana@globex.io", "eli@globex.io"]
    }
  ]
}

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

{ "success": false, "error": "No company selected" }

List Account Suggestions

Finds work email domains that several of your contacts share, such as seven contacts at acme.com, so you can turn them into accounts. Nothing is created until you accept a suggestion. See Accounts. These are skipped:

Personal and disposable email providers, such as gmail.com, outlook.com and yopmail.com
Your own sending domains and their subdomains
Domains where any contact already belongs to an account, for example through an organization ID sync
Domains an account already uses as its domain or external ID

Requires the subscribers:read scope.

Request

number

default:"3"

Contacts a domain needs to be suggested. Values outside 2 to 1000 are clamped, and non-numeric values use the default.

number

default:"25"

Number of suggestions, largest domains first. Values outside 1 to 100 are clamped.

curl "https://api.sequenzy.com/api/v1/account-suggestions?minContacts=3" \
  -H "Authorization: Bearer API_KEY"

Response

array

Suggested accounts, largest first.

Show properties

string

The shared work email domain.

string

The name the account gets when you accept it, derived from the domain.

number

Contacts at the domain.

string[]

Up to 10 of those contacts’ emails, alphabetical, so you can check who is behind the suggestion before accepting it.

{
  "success": true,
  "suggestions": [
    {
      "domain": "acme.com",
      "name": "Acme",
      "contactCount": 7,
      "sampleEmails": ["ana@acme.com", "ben@acme.com", "chris@acme.com"]
    },
    {
      "domain": "globex.io",
      "name": "Globex",
      "contactCount": 4,
      "sampleEmails": ["dana@globex.io", "eli@globex.io"]
    }
  ]
}

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

{ "success": false, "error": "No company selected" }

List Account Suggestions

curl --request GET \
  --url https://api.sequenzy.com/api/v1/account-suggestions \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.sequenzy.com/api/v1/account-suggestions', 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.sequenzy.com/api/v1/account-suggestions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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.sequenzy.com/api/v1/account-suggestions"

	req, _ := http.NewRequest("GET", 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.sequenzy.com/api/v1/account-suggestions")

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

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

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

{
  "success": true,
  "suggestions": [
    {
      "domain": "acme.com",
      "name": "Acme",
      "contactCount": 7,
      "sampleEmails": ["ana@acme.com", "ben@acme.com", "chris@acme.com"]
    },
    {
      "domain": "globex.io",
      "name": "Globex",
      "contactCount": 4,
      "sampleEmails": ["dana@globex.io", "eli@globex.io"]
    }
  ]
}

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

{ "success": false, "error": "No company selected" }

​List Account Suggestions

​Request

​Response

List Account Suggestions

Request

Response