Integration

How to integrate with vcards by TicTAP

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

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

Request Body:

Responses:

201 - Success

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

Responses:

200 - Success

404 - Not Found

Edit a vcard

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

Parameters:

Name Type Description Required
sku string SKU code Yes

Request Body:

Responses:

200 - Success

Delete a vcard

Deletes a vcard from the team by the given SKU.

Parameters:

Name Type Description Required
sku string SKU code Yes

Responses:

204 - Success