Search Contacts (Get Contacts)

POST https://services.leadconnectorhq.com/contacts/search

Request

Security: Bearer Auth

Utiliza el Access Token generado con tipo de usuario Subcuenta o el Token de Integración Privada de la Subcuenta en PowerLeads. Proporciona tu token Bearer en el encabezado Authorization al realizar solicitudes a recursos protegidos.

Example: Authorization: Bearer 123

Headers

Authorization

string

required

Access Token

Example: Bearer 9c48df2694a849b6089f9d0d3513efe

Version

string

required

API Version

Allowed value: 2021-07-28

Request Sample: Shell / cURL

curl --request POST \
  --url https://services.leadconnectorhq.com/contacts/search \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer 123' \
  --header 'Content-Type: application/json' \
  --header 'Version: 2021-07-28' \
  --data '{}'

Response Example

{
  "contacts": [
    {
      "id": "102goXVW3lIExEQPOnd3",
      "phoneLabel": "Mobile",
      "country": "United States",
      "address": "123 Main Street",
      "source": "Website",
      "type": "lead",
      "locationId": "502goXVW3lIExEQPOnd3",
      "dnd": false,
      "state": "California",
      "businessName": "Acme Corporation",
      "customFields": [
        {
          "id": "MgobCB14YMVKuE4Ka8p1",
          "value": "name"
        }
      ],
      "tags": [
        "tag-1",
        "tag-2"
      ],
      "dateAdded": "2024-06-06T18:54:57.221Z",
      "additionalEmails": [
        "john@example.com",
        "jane@example.com"
      ],
      "phone": "+123456789",
      "companyName": "XYZ Corp",
      "additionalPhones": [
        "123456789",
        "987654321"
      ],
      "dateUpdated": "2024-06-06T18:54:57.221Z",
      "city": "New York",
      "dateOfBirth": "1990-01-01",
      "firstNameLowerCase": "john",
      "lastNameLowerCase": "doe",
      "email": "john@example.com",
      "assignedTo": "182goXVW3lIExEQPOnd3",
      "followers": [
        "682goXVW3lIExEQPOnd3",
        "582goXVW3lIExEQPOnd3"
      ],
      "validEmail": true,
      "dndSettings": {
        "Call": {
          "status": "active",
          "message": "string",
          "code": "string"
        },
        "Email": {
          "status": "active",
          "message": "string",
          "code": "string"
        },
        "SMS": {
          "status": "active",
          "message": "string",
          "code": "string"
        },
        "WhatsApp": {
          "status": "active",
          "message": "string",
          "code": "string"
        },
        "GMB": {
          "status": "active",
          "message": "string",
          "code": "string"
        },
        "FB": {
          "status": "active",
          "message": "string",
          "code": "string"
        }
      },
      "opportunities": [
        {
          "id": "1a2b3c4d5e6f7g8h9i0j",
          "pipeline_id": "pipeline123",
          "pipeline_stage_id": "stage456",
          "monetary_value": 10000,
          "status": "open"
        }
      ],
      "postalCode": "12345",
      "businessId": "282goXVW3lIExEQPOnd3",
      "searchAfter": [
        1234,
        "102goXVW3lIExEQPOnd3"
      ]
    }
  ],
  "total": 120
}