Contacts

Manage contact information for individuals associated with companies. Contacts can have various roles such as primary contact, billing contact, or operations contact.

Quick Reference

Method

Endpoint

Description

GET

/api/contacts/{id}

Get contact by ID

GET

/api/contacts/user

GET

/api/contacts/{contactId}/editdetails

PUT

/api/contacts/{contactId}/editdetails

POST

/api/contacts/editdetails

POST

/api/contacts/search

POST

/api/contacts/v2/search

POST

/api/contacts/customers

GET

/api/contacts/{contactId}/primarydetails

GET /api/contacts/{id}

Get contact by ID

Retrieves information about a specific contact.

Parameters:

Path Parameters:

  • id (integer, path) (required): No description available

Response Type:

Contact

See the model documentation for detailed field descriptions.

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/contacts/{id}"
,
    id=789e0123-e89b-12d3-a456-426614174002

)

# Process the response
print(response)

Sample Response:

 1{
 2  "id": 266841,
 3  "contactDisplayId": "1",
 4  "fullName": "John Doe",
 5  "firstName": "John",
 6  "lastName": "Doe",
 7  "contactTypeId": 1,
 8  "companyId": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
 9  "isActive": true,
10  "primaryEmail": "john.doe@example.com",
11  "primaryPhone": "555-123-4567"
12}

GET /api/contacts/user

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/contacts/user"

)

# Process the response
print(response)

Sample Response:

1{
2  "status": "success",
3  "data": {}
4}

GET /api/contacts/{contactId}/editdetails

Parameters:

Path Parameters:

  • contactId (integer, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/contacts/{contactId}/editdetails"
,
    contactId=456e7890-e89b-12d3-a456-426614174001

)

# Process the response
print(response)

Sample Response:

1[]

PUT /api/contacts/{contactId}/editdetails

Parameters:

Path Parameters:

  • contactId (integer, path) (required): No description available

Query Parameters:

  • franchiseeId (string, query): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.put(
    "/api/contacts/{contactId}/editdetails"
,
    contactId="456e7890-e89b-12d3-a456-426614174001"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{}

POST /api/contacts/editdetails

Parameters:

Query Parameters:

  • franchiseeId (string, query): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/contacts/editdetails"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{}

POST /api/contacts/search

Parameters:

Query Parameters:

  • companyId (string, query): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/contacts/search"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1[]

POST /api/contacts/v2/search

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/contacts/v2/search"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1[]

POST /api/contacts/customers

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/contacts/customers"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "789e0123-e89b-12d3-a456-426614174002",
3  "status": "created",
4  "message": "Resource created successfully"
5}

GET /api/contacts/{contactId}/primarydetails

Parameters:

Path Parameters:

  • contactId (integer, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/contacts/{contactId}/primarydetails"
,
    contactId=456e7890-e89b-12d3-a456-426614174001

)

# Process the response
print(response)

Sample Response:

1[]