🖇️Calls

API Endpoints for Calls

List Calls GET

Endpoint: https://subdomain.appcrm.com.br/api/calls

Headers

Content-Type	Required	string	application/json
Accept	Required	string	application/json
Authorization	Required	string	Bearer {token}

Query Parameters

order	Optional	string	Sort the results being queried. Example: ?order=created_at or ?order=created_at|desc
select	Optional	string	Select only the provided fields, useful for query optimization. Example: ?select=first_name;id
per_page	Optional	integer	Provide the total number of records to query per page. Example: ?per_page=20
page	Optional	integer	The page number to retrieve results for. Example: ?page=2
q	Optional	string	Search records by a given query. Example: ?q=John
search_fields	Optional	string	Change the fields that the search will be performed to Example:?search_fields=email:like;phones.number:=
search_match	Optional	string	By default the search queries are performed using the OR comparison operator for each query parameter, if you need to match all parameters, you will need to use the AND comparison operator. Example: ?search_match=and

Retrieve Call GET

Endpoint: https://subdomain.appcrm.com.br/api/calls/{id}

Headers

Content-Type	Required	string	application/json
Accept	Required	string	application/json
Authorization	Required	string	Bearer {token}

Path Parameters

id	Required	integer	The ID of the record

Log Call POST

Endpoint: https://subdomain.appcrm.com.br/api/calls

Headers

Content-Type	Required	string	application/json
Accept	Required	string	application/json
Authorization	Required	string	Bearer {token}

Body Parameters

body	Required	string
date	Required	date	The date when the call is performed in UTC format
call_outcome_id	Required	integer	call outcome
via_resource	Required	string	Any of ['contacts', 'companies', 'deals']
via_resource_id	Required	integer
task_date	Optional	date	Create follow up activity of type task with the given date in UTC format
contacts	Optional	array
companies	Optional	array
deals	Optional	array

At this time, associating calls to multiple resources is available only via API, however, it's recommend to associate the record only to one resource as you won't be able to update them via the dashboard.

Update Call PUT

Endpoint: https://crm.example.com/api/calls/{id}

Headers

Content-Type	Required	string	application/json
Accept	Required	string	application/json
Authorization	Required	string	Bearer {token}

Path Parameters

id	Required	integer	The ID of the record

Body Parameters

body	Required	string
date	Required	date	The date when the call is performed in UTC format
call_outcome_id	Required	integer	call outcome
via_resource	Required	string	Any of ['contacts', 'companies', 'deals']
via_resource_id	Required	integer
contacts	Optional	array
companies	Optional	array
deals	Optional	array

At this time, associating calls to multiple resources is available only via API, however, it's recommend to associate the record only to one resource as you won't be able to update them via the dashboard.

Delete Call DELETE

Endpoint: https://subdomain.appcrm.com.br/api/calls/{id}

Headers

Content-Type	Required	string	application/json
Accept	Required	string	application/json
Authorization	Required	string	Bearer {token}

Path Parameters

id	Required	integer	The ID of the record

Search Calls GET

Endpoint: https://subdomain.appcrm.com.br/api/calls/search?q={query}

Use this endpoint to perform search without pagination and use the take parameter if you need to limit the results.

Headers

Content-Type	Required	string	application/json
Accept	Required	string	application/json
Authorization	Required	string	Bearer {token}

Path Parameters

q		string

Query Parameters

take	Optional	integer	The maximum number of results to query Example: ?take=1
order	Optional	string	Sort the results being queried. Example: ?order=created_at or ?order=created_at|desc
select	Optional	string	Select only the provided fields, useful for query optimization. Example: ?select=first_name;id
search_fields	Optional	string	Change the fields that the search will be performed to Example:?search_fields=email:like;phones.number:=
search_match	Optional	string	By default the search queries are performed using the OR comparison operator for each query parameter, if you need to match all parameters, you will need to use the AND comparison operator. Example: ?search_match=and