Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cloudtalk-bulks-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: CloudTalk Bulks API
description: '# Introduction
Welcome to CloudTalk API reference!'
contact:
name: CloudTalk API Support
url: https://www.cloudtalk.io/contact
version: '1.7'
x-logo:
url: https://my.cloudtalk.io/img/logo-cloudtalk-color.png
servers:
- url: https://my.cloudtalk.io/api
tags:
- name: Bulks
description: Bulk actions.
paths:
/bulk/contacts.json:
post:
tags:
- Bulks
summary: Contact actions
description: Max 10 actions are available in one request. Only sent parameters/values will be updated. If you want to clear the value, just set empty string for that attribute. After sending empty string for properties of `ContactNumber`, `ContactEmail`, `ContactsTag` or `ContactAttribute` all data from these properties will be cleared. When you send values for properties of `ContactNumber`, `ContactEmail`, `ContactsTag` or `ContactAttribute` only these data will be updated, all other will be cleared.
requestBody:
content:
application/json:
schema:
type: array
maxItems: 10
example:
- action: add_contact
command_id: '123'
data:
name: John Snow
title: Ing.
company: Night watch
industry: it
website: https://www.castleblack.com/
address: Room 1
city: New York
zip: '18104'
state: NY
country_id: 201
ContactNumber:
- public_number: 421901123456
ContactEmail:
- email: snow@example.com
ContactsTag:
- name: watch
- action: delete_contact
command_id: '1234'
data:
id: 1234
- action: edit_contact
command_id: '12345'
data:
id: 123
name: Daenerys Stormborn
title: Ing.
company: Targaryen inc.
industry: it
website: https://www.fireandblood.com/
address: First st.
zip: '18104'
state: NY
country_id: 201
ContactNumber:
- public_number: 421901123456
- public_number: 421908123456
ContactEmail:
- email: danny@example.com
- email: targ@example.com
ContactsTag:
- name: fire
- name: dragons
- action: add_activity
command_id: '123456'
data:
contact_id: 123
type: order
name: Burn the usurper
activity_date: '2020-08-22T09:53:47.000Z'
description: Defeat the forces at kings landing
activity_author: Danny Stormborn
external_id: 123456
external_url: https://fireandblood.io/order
- action: delete_activity
command_id: '1234567'
data:
id: 12345
- action: edit_activity
command_id: '12345678'
data:
id: 123456
contact_id: 123456
type: order
name: Defend the Wall
activity_date: '2020-08-25T09:53:47.000Z'
description: Repel white walkers attack
activity_author: Danny Stormborn
external_id: 1234567
external_url: https://fireandblood.com/defend
- action: add_note
command_id: '123456789'
data:
contact_id: 1234
note: Dont feed the dragon
user_id: 12345678
- action: delete_note
command_id: '1234567890'
data:
id: 1234567890
- action: edit_note
command_id: 1234567890A
data:
id: 123456789
note: Seriously, dont
user_id: 1075
contact_id: 1234
items:
required:
- action
- command_id
- data
type: object
properties:
action:
type: string
description: Action
enum:
- add_contact
- edit_contact
- delete_contact
- add_activity
- edit_activity
- delete_activity
- add_note
- edit_note
- delete_note
command_id:
$ref: '#/components/schemas/command_id'
data:
oneOf:
- title: add contact
type: object
properties:
name:
type: string
description: Name. Only for actions add_contact, edit_contact, add_activity, edit_activity.
title:
type: string
description: Title. Only for actions add_contact, edit_contact.
company:
type: string
description: Company. Only for actions add_contact, edit_contact.
industry:
type: string
description: Industry. Only for actions add_contact, edit_contact.
website:
type: string
description: Website. Only for actions add_contact, edit_contact.
address:
type: string
description: Address. Only for actions add_contact, edit_contact.
city:
type: string
description: City. Only for actions add_contact, edit_contact.
zip:
type: string
description: ZIP. Only for actions add_contact, edit_contact.
state:
type: string
description: State. Only for actions add_contact, edit_contact.
country_id:
type: integer
description: Country ID. Only for actions add_contact, edit_contact.
favorite_agent:
type: integer
description: Favorite agent. Only for actions add_contact, edit_contact.
ExternalUrl:
$ref: '#/components/schemas/ExternalUrlArray'
ContactNumber:
$ref: '#/components/schemas/ContactNumberArray'
ContactEmail:
$ref: '#/components/schemas/ContactEmailArray'
ContactsTag:
$ref: '#/components/schemas/ContactsTag'
ContactAttribute:
type: array
description: Attributes for contact. Only for actions add_contact, edit_contact.
items:
type: object
properties:
attribute_id:
$ref: '#/components/schemas/ContactAttribute/items/properties/attribute_id'
value:
$ref: '#/components/schemas/ContactAttribute/items/properties/value'
- title: delete contact/note/activity
type: object
properties:
id:
type: integer
description: ID. Only for actions edit_contact, delete_contact, edit_activity, delete_activity, edit_note, delete_note.
- title: edit contact
type: object
properties:
id:
type: integer
description: ID. Only for actions edit_contact, delete_contact, edit_activity, delete_activity, edit_note, delete_note.
name:
type: string
description: Name. Only for actions add_contact, edit_contact, add_activity, edit_activity.
title:
type: string
description: Title. Only for actions add_contact, edit_contact.
company:
type: string
description: Company. Only for actions add_contact, edit_contact.
industry:
type: string
description: Industry. Only for actions add_contact, edit_contact.
website:
type: string
description: Website. Only for actions add_contact, edit_contact.
address:
type: string
description: Address. Only for actions add_contact, edit_contact.
city:
type: string
description: City. Only for actions add_contact, edit_contact.
zip:
type: string
description: ZIP. Only for actions add_contact, edit_contact.
state:
type: string
description: State. Only for actions add_contact, edit_contact.
country_id:
type: integer
description: Country ID. Only for actions add_contact, edit_contact.
favorite_agent:
type: integer
description: Favorite agent. Only for actions add_contact, edit_contact.
ExternalUrl:
$ref: '#/components/schemas/ExternalUrlArray'
ContactNumber:
$ref: '#/components/schemas/ContactNumberArray'
ContactEmail:
$ref: '#/components/schemas/ContactEmailArray'
ContactsTag:
$ref: '#/components/schemas/ContactsTag'
ContactAttribute:
type: array
description: Attributes for contact. Only for actions add_contact, edit_contact.
items:
type: object
properties:
attribute_id:
$ref: '#/components/schemas/ContactAttribute/items/properties/attribute_id'
value:
$ref: '#/components/schemas/ContactAttribute/items/properties/value'
- title: add activity
type: object
properties:
name:
type: string
description: Name. Only for actions add_contact, edit_contact, add_activity, edit_activity.
contact_id:
type: integer
description: Contact ID. Only for actions add_activity, edit_activity, add_note, edit_note.
type:
$ref: '#/components/schemas/ContactActivity/properties/type'
activity_date:
$ref: '#/components/schemas/ContactActivity/properties/activity_date'
description:
$ref: '#/components/schemas/ContactActivity/properties/description'
activity_author:
$ref: '#/components/schemas/ContactActivity/properties/activity_author'
external_id:
$ref: '#/components/schemas/ContactActivity/properties/external_id'
external_url:
$ref: '#/components/schemas/ContactActivity/properties/external_url'
- title: edit activity
type: object
properties:
id:
type: integer
description: ID. Only for actions edit_contact, delete_contact, edit_activity, delete_activity, edit_note, delete_note.
name:
type: string
description: Name. Only for actions add_contact, edit_contact, add_activity, edit_activity.
contact_id:
type: integer
description: Contact ID. Only for actions add_activity, edit_activity, add_note, edit_note.
type:
$ref: '#/components/schemas/ContactActivity/properties/type'
activity_date:
$ref: '#/components/schemas/ContactActivity/properties/activity_date'
description:
$ref: '#/components/schemas/ContactActivity/properties/description'
activity_author:
$ref: '#/components/schemas/ContactActivity/properties/activity_author'
external_id:
$ref: '#/components/schemas/ContactActivity/properties/external_id'
external_url:
$ref: '#/components/schemas/ContactActivity/properties/external_url'
- title: add note
type: object
properties:
contact_id:
type: integer
description: Contact ID. Only for actions add_activity, edit_activity, add_note, edit_note.
user_id:
$ref: '#/components/schemas/ContactNote/properties/user_id'
note:
$ref: '#/components/schemas/ContactNote/properties/note'
- title: edit note
type: object
properties:
id:
type: integer
description: ID. Only for actions edit_contact, delete_contact, edit_activity, delete_activity, edit_note, delete_note.
contact_id:
type: integer
description: Contact ID. Only for actions add_activity, edit_activity, add_note, edit_note.
user_id:
$ref: '#/components/schemas/ContactNote/properties/user_id'
note:
$ref: '#/components/schemas/ContactNote/properties/note'
required: true
responses:
'200':
description: No error
content:
application/json:
schema:
type: object
properties:
responseData:
type: object
properties:
status:
$ref: '#/components/schemas/StatusCode/properties/status'
data:
$ref: '#/components/schemas/ContactsBulkDataResponse'
example:
responseData:
status: 200
data:
- command_id: '123'
status: 201
data:
id: '123'
- command_id: '1234'
status: 200
- command_id: '12345'
status: 200
- command_id: '123456'
status: 201
data:
id: '123456'
- command_id: '1234567'
status: 200
- command_id: '12345678'
status: 200
- command_id: '12356789'
status: 201
data:
id: '123456789'
- command_id: '1234567890'
status: 200
- command_id: 123456789A
status: 200
'406':
description: Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorInvalidData'
example:
responseData:
status: 406
message: Invalid input data.
data:
email:
- Please supply a valid email address.
'500':
description: Something went wrong
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorData'
example:
responseData:
status: 500
message: Something went wrong.
x-codegen-request-body-name: body
operationId: postBulkContactsJson
x-operation-id-source: derived
components:
schemas:
ContactEmailArray:
type: array
description: Emails assigned to contact
items:
type: object
properties:
email:
type: string
description: Email address
format: email
ContactActivity:
type: object
properties:
id:
type: integer
description: Activity ID
contact_id:
type: integer
description: Assigned contact ID
type:
type: string
description: Type of activity
enum:
- order
- task
- chat
- ticket
- other
- invoice
- proforma
- estimate
- cancel
name:
type: string
description: Name/Title
description:
type: string
description: Detailed description
activity_author:
type: string
description: Author of activity - user name you want to show
external_id:
type: integer
description: Activity ID from external resource - e.g. your order ID
external_url:
type: string
description: External url which can be opened from activity detail
activity_date:
type: string
description: Activity date and time. Set to current company time by default.
format: date-time
created:
type: string
description: Created date and time
format: date-time
description: Activity data
ContactNote:
type: object
properties:
id:
type: integer
description: Note ID
contact_id:
type: integer
description: Assigned contact ID
user_id:
type: integer
description: Assigned agent ID
note:
type: string
description: Note content
created:
type: string
description: Created date and time
format: date-time
description: Note data
command_id:
type: string
description: Unique action identifier
ContactNumberArray:
type: array
description: Numbers assigned to contact
items:
type: object
properties:
public_number:
type: string
description: Full number in international E.164 format
StatusCode:
type: object
properties:
status:
type: string
description: Status code
ContactAttribute:
type: array
description: Attributes for contact - can include multiple
items:
type: object
properties:
attribute_id:
type: integer
description: Attribute ID
title:
type: string
description: Attribute name (max 255 chars per attribute)
maximum: 255
value:
type: string
description: Attribute value (max 255 chars per attribute)
maximum: 255
ErrorInvalidData:
type: object
properties:
status:
type: string
description: Status code
message:
type: string
description: The error message
data:
type: object
properties: {}
description: More data explaining the error
ContactsTag:
type: array
description: Tags for contact - can include multiple
items:
type: object
properties:
name:
type: string
description: Tag
ContactsBulkDataResponse:
type: array
description: Response data
items:
type: object
properties:
command_id:
$ref: '#/components/schemas/command_id'
status:
$ref: '#/components/schemas/StatusCode/properties/status'
message:
$ref: '#/components/schemas/ErrorInvalidData/properties/message'
data:
type: object
properties: {}
description: Available only in add actions or invalid action data. More data explaining the error or id of new entity.
ExternalUrlArray:
type: array
maxItems: 3
description: List of all URLs which points to a detail page of a contact in an external service, e.g. CRMs, Helpdesk or any other custom service you use. You may list up to 3 URLs.
items:
type: object
properties:
name:
maxLength: 30
type: string
description: Name of external service. Name will be shown to agents while working with contacts.
url:
type: string
description: External URL to contact page
ErrorData:
type: object
properties:
status:
type: string
description: Status code
message:
type: string
description: The error message