Check a connections import

POST

crm

connections-import

status

curl --request POST \
  --url https://api.groovin.ai/functions/v1/api/v1/crm/connections-import/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "rows": "none"
}'

import requests

url = "https://api.groovin.ai/functions/v1/api/v1/crm/connections-import/status"

payload = { "rows": "none" }
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({rows: 'none'})
};

fetch('https://api.groovin.ai/functions/v1/api/v1/crm/connections-import/status', 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.groovin.ai/functions/v1/api/v1/crm/connections-import/status",
  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([
    'rows' => 'none'
  ]),
  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.groovin.ai/functions/v1/api/v1/crm/connections-import/status"

	payload := strings.NewReader("{\n  \"rows\": \"none\"\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.groovin.ai/functions/v1/api/v1/crm/connections-import/status")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"rows\": \"none\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.groovin.ai/functions/v1/api/v1/crm/connections-import/status")

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  \"rows\": \"none\"\n}"

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

{
  "import_id": "example-import-id",
  "status": "running",
  "dry_run": true,
  "crm_name": "attio",
  "file_name": "Connections.csv",
  "created_at": "2026-11-02T09:00:00.000Z",
  "started_at": "2026-11-02T09:00:04.000Z",
  "finished_at": null,
  "total_rows": 2400,
  "processed_rows": 600,
  "pending_rows": 1800,
  "counts": {
    "contacts_found": 120,
    "contacts_found_by_name_and_company": 4,
    "contacts_created": 0,
    "contacts_would_create": 460,
    "contacts_possible_duplicate": 8,
    "companies_found": 90,
    "companies_created": 0,
    "companies_would_create": 310,
    "company_domains_found": 240,
    "companies_domain_pending": 70,
    "skipped_blocked": 0,
    "skipped_duplicate_in_file": 2,
    "skipped_unusable": 10,
    "errors": 0,
    "ambiguous": 0
  },
  "lists": {
    "contact": null,
    "company": null
  },
  "column_map": {},
  "parse_warnings": [],
  "last_error": null,
  "is_processing": true,
  "cancel_requested_at": null,
  "rows_purged_at": null,
  "finished_notified_at": null,
  "retention_hours": 72,
  "company_domain_credits_remaining": 200,
  "domain_credits_exhausted_at": null,
  "on_behalf_of": null,
  "update_recognised_contacts": true,
  "poll_after_seconds": 120,
  "next_step": "Check again in about two minutes.",
  "rows_available": true
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Safe to try. One exception: asking about a stalled import can start it again, and a real run then carries on writing to your CRM.

What this call does


LinkedIn	None
Your CRM	None, but a stalled real run can resume and keep writing
Repeating it	Safe to repeat: wait for `poll_after_seconds` between calls.

Your AI assistant reaches the same action through the MCP tool get_linkedin_connections_import.

Authorizations

Authorization

string

header

required

Your Groovin API key (gv_live_…), created in the extension under Settings, MCP and API.

Body

application/json

import_id

string

Which import. Leave it out for your most recent one.

rows

enum<string>

none (the default) gives counts only. needs_attention lists what you must settle yourself. created, skipped and all list the rest.

Available options:

none,

needs_attention,

created,

skipped,

all

limit

integer

Rows per page: 25 by default, 100 at most.

Required range: 1 <= x <= 100

offset

integer

How many rows to skip, to get the next page.

Required range: x >= 0

Response

Success.

The state of an import. Every import route answers with this.

import_id

string

required

The import.

status

string

required

ready or running while it works, then completed, cancelled or failed.

dry_run

boolean

required

true for a preview.

crm_name

string

required

Your CRM: "attio" or "hubspot".

file_name

string | null

required

The name of the result file.

created_at

string

required

When the import was created.

started_at

string | null

required

When it started.

finished_at

string | null

required

When it finished.

total_rows

integer

required

Data rows in the file. Compare this with your file: a mismatch means the file was cut on the way in.

processed_rows

integer

required

Rows done.

pending_rows

integer

required

Rows left.

counts

object

required

The running totals of an import. On a preview, *_would_create says what a real run would create.

Show child attributes

lists

object

required

The CRM lists the import adds records to.

Show child attributes

column_map

object

required

Which column of the file was read as what.

parse_warnings

string[]

required

What the file reader could not read.

last_error

string | null

required

The latest problem, if any.

is_processing

boolean

required

true while rows are being worked on right now.

cancel_requested_at

string | null

required

When you asked to stop.

rows_purged_at

string | null

required

When the row data was deleted. No row detail and no re-run after that.

finished_notified_at

string | null

required

When you were emailed.

retention_hours

integer

required

How long row data is kept, in hours.

company_domain_credits_remaining

integer | null

required

Your domain credits when this run last looked.

domain_credits_exhausted_at

string | null

required

When credits ran out. Later companies were created with a name but no domain.

on_behalf_of

object | null

required

The teammate whose connections these are. null means your own.

Show child attributes

update_recognised_contacts

boolean

required

true when a real run updates the contacts it recognises.

poll_after_seconds

integer | null

required

Wait this long before asking again. null once the import can no longer change.

next_step

string

required

What to do now, in one sentence.

rows_available

boolean

required

false once the row data was deleted: counts only.

rows

object[]

One page of rows, if you asked.

Show child attributes

rows_total_matched

integer

Rows matching your filter.

rows_returned

integer

Rows in this answer.

rows_offset

integer

The offset you sent.

rows_truncated

boolean

true when more rows exist: ask with a new offset.

Check a connections import

curl --request POST \
  --url https://api.groovin.ai/functions/v1/api/v1/crm/connections-import/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "rows": "none"
}'

import requests

url = "https://api.groovin.ai/functions/v1/api/v1/crm/connections-import/status"

payload = { "rows": "none" }
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({rows: 'none'})
};

fetch('https://api.groovin.ai/functions/v1/api/v1/crm/connections-import/status', 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.groovin.ai/functions/v1/api/v1/crm/connections-import/status",
  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([
    'rows' => 'none'
  ]),
  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.groovin.ai/functions/v1/api/v1/crm/connections-import/status"

	payload := strings.NewReader("{\n  \"rows\": \"none\"\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.groovin.ai/functions/v1/api/v1/crm/connections-import/status")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"rows\": \"none\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.groovin.ai/functions/v1/api/v1/crm/connections-import/status")

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  \"rows\": \"none\"\n}"

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

{
  "import_id": "example-import-id",
  "status": "running",
  "dry_run": true,
  "crm_name": "attio",
  "file_name": "Connections.csv",
  "created_at": "2026-11-02T09:00:00.000Z",
  "started_at": "2026-11-02T09:00:04.000Z",
  "finished_at": null,
  "total_rows": 2400,
  "processed_rows": 600,
  "pending_rows": 1800,
  "counts": {
    "contacts_found": 120,
    "contacts_found_by_name_and_company": 4,
    "contacts_created": 0,
    "contacts_would_create": 460,
    "contacts_possible_duplicate": 8,
    "companies_found": 90,
    "companies_created": 0,
    "companies_would_create": 310,
    "company_domains_found": 240,
    "companies_domain_pending": 70,
    "skipped_blocked": 0,
    "skipped_duplicate_in_file": 2,
    "skipped_unusable": 10,
    "errors": 0,
    "ambiguous": 0
  },
  "lists": {
    "contact": null,
    "company": null
  },
  "column_map": {},
  "parse_warnings": [],
  "last_error": null,
  "is_processing": true,
  "cancel_requested_at": null,
  "rows_purged_at": null,
  "finished_notified_at": null,
  "retention_hours": 72,
  "company_domain_credits_remaining": 200,
  "domain_credits_exhausted_at": null,
  "on_behalf_of": null,
  "update_recognised_contacts": true,
  "poll_after_seconds": 120,
  "next_step": "Check again in about two minutes.",
  "rows_available": true
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Get started

Safety and limits

REST API

MCP

Webhooks

Help

Check a connections import

What this call does

Authorizations

Body

Response

​What this call does

Authorizations

Body

Response

What this call does