Integration

• REST API

REST API

The documentation of the api can be found in Api Docs page. This article defines the resources available in the Vcards integration API.

Access token

In order to access the API it is required having an accessToken. Once you have an accessToken you must include it in every request as a HTTP header

AccessToken: "YOUR_API_KEY_HERE"

If you need to try different API calls you can do it from the same Api Docs page, by using the "authorize" button

List vcards

Retrieve a paginated list of vcards with optional filtering and search functionality.

Parameters:

Name	Type	Description	Required
query	string	Search a string in name, code, or SKU	No
filters[]	array	Filter by field values, can include multiple in the format filters[field-slug]=value. Example: filters[email]=mymail	No
page	string	Page number for pagination (default is 1)	No
limit	string	Number of items per page (default is 25)	No

• query: A string to search in the tag’s name, code, or SKU.
• filters[]: An array for filtering by specific field values. Multiple filters can be passed in the format filters[field-slug]=value.
• page: A string representing the page number for pagination.
• limit: A string representing the number of items per page.

Responses:

The response for this endpoint would contain a paginated list of tags with the applied filters and search criteria.

Create a new vcard

Creates a new vcard in the team.

Parameters:

Name	Type	Description	Required
name	string	Full name	Yes
collection	string	Collection code where the vcard is created	Yes
email	string	Email related to the vcard	Yes
phone	string	Phone number	No
position	object	Position of the vcard	No
mobile-phone	string	Mobile phone number	No
address	string	Address of the vcard	No
department	string	Department of the vcard	No

• sku: A string representing the SKU (Stock Keeping Unit) used to identify the vcard to be updated.
• { [field-slug]: string }: A JSON object containing the vcard details. Each of the keys belongs to the slug of the field in the vcard.

Request Body:

• Media type: application/json
• Example request body:

   {
      "name": "Full name",
      "collection" : "2423AX23",
      "email": "john.doe@domain.com",
      "phone": "+1234567890",
      "position": { 
        "en":  "CEO", 
        "es": "Director General" 
      },
      "mobile-phone": "+1234567890",
      "address": "1234 Main St, City, Country",
      "department" : "Marketing"
  }
  

Responses:

201 - Success

• Media type: application/json
• Example response:

  {
      "code": "BVHWSTMGL",
      "sku": "ABC000",
      "values": {
        "name": "Full name",
        "email": "john.doe@domain.com",
        "phone": "+1234567890",
        "position": { 
          "en":  "CEO", 
          "es": "Director General" 
        },
        "mobile-phone": "+1234567890",
        "address": "1234 Main St, City, Country",
        "department" : "Marketing"
      }
  }
  
  

Show vcard detail

Retrieves vcard details by the given SKU. The SKU is a unique reference for the vcard.

Parameters:

Name	Type	Description	Required
sku	string	SKU code	Yes

• sku: A string representing the SKU (Stock Keeping Unit) used to retrieve specific vcard details.

Responses:

200 - Success

• Media type: application/json
• Example response:

  {
      "code": "BVHWSTMGL",
      "sku": "ABC000",
      "values": {
        "name": "Full name",
        "email": "john.doe@domain.com",
        "phone": "+1234567890",
        "position": { 
          "en":  "CEO", 
          "es": "Director General" 
        },
        "mobile-phone": "+1234567890",
        "address": "1234 Main St, City, Country",
        "department" : "Marketing"
  
      }
  }
  

404 - Not Found

• Description: Vcard not found in the team for the given SKU.

Edit a vcard

Updates the details of an existing vcard identified by the SKU.

Parameters:

Name	Type	Description	Required
sku	string	SKU code	Yes

• sku: A string representing the SKU (Stock Keeping Unit) used to identify the vcard to be updated.

Request Body:

• Media type: application/json
• Example request body:

   {
    "code": "BVHWSTMGL",
    "sku": "ABC000",
    "values": {
      "name": "Full name",
      "email": "john.doe@domain.com",
      "phone": "+1234567890",
      "position": { 
        "en":  "CEO", 
        "es": "Director General" 
      },
      "mobile-phone": "+1234567890",
      "address": "1234 Main St, City, Country",
      "department" : "Marketing"
  
    }
  }
  

Responses:

200 - Success

• Media type: application/json

• Example response:

  {
      "code": "BVHWSTMGL",
      "sku": "ABC000",
      "values": {
        "name": "Full name",
        "email": "john.doe@domain.com",
        "phone": "+1234567890",
        "position": { 
          "en":  "CEO", 
          "es": "Director General" 
        },
        "mobile-phone": "+1234567890",
        "address": "1234 Main St, City, Country",
        "department" : "Marketing"
  
      }
  }
  

• Description: Successful update of the vcard.

Delete a vcard

Deletes a vcard from the team by the given SKU.

Parameters:

Name	Type	Description	Required
sku	string	SKU code	Yes

• sku: A string representing the SKU (Stock Keeping Unit) used to delete the vcard.

Responses:

204 - Success

• Description: Vcard successfully deleted from the team.
• Media type: application/json