vCita Messaging Channels API
The Messaging Channels API from vCita — 1 operation(s) for messaging channels.
The Messaging Channels API from vCita — 1 operation(s) for messaging channels.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/vcita:vcita-messaging-channels-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Communication Messaging Channels API
description: Unified OpenAPI specification for communication domain
version: '3.0'
x-generated:
sourceFiles:
- contact_channels.json
- communication.json
- staff_notification.json
- business_phone_numbers.json
- legacy_v1_communication.json
- activity_message.json
- communication.json
- conversations.json
- notification_template.json
- legacy_v2_communication.json
- messages.json
pathNormalizations:
- file: communication.json
basePath: /business/communication
transformations:
- original: /channels
normalized: /business/communication/channels
basePath: /business/communication
- original: /channels/{uid}
normalized: /business/communication/channels/{uid}
basePath: /business/communication
- original: /messages
normalized: /business/communication/messages
basePath: /business/communication
- original: /messages/{messageUid}
normalized: /business/communication/messages/{messageUid}
basePath: /business/communication
- original: /sessions
normalized: /business/communication/sessions
basePath: /business/communication
- original: /sessions/typing
normalized: /business/communication/sessions/typing
basePath: /business/communication
- original: /sessions/{uid}
normalized: /business/communication/sessions/{uid}
basePath: /business/communication
- file: legacy_v1_communication.json
basePath: /platform/v1
transformations:
- original: /conversations
normalized: /platform/v1/conversations
basePath: /platform/v1
- original: /clients/{client_id}/conversations
normalized: /platform/v1/clients/{client_id}/conversations
basePath: /platform/v1
- original: /messages
normalized: /platform/v1/messages
basePath: /platform/v1
- original: /numbers/dedicated_numbers/assign
normalized: /platform/v1/numbers/dedicated_numbers/assign
basePath: /platform/v1
- original: /numbers/dedicated_numbers/set_two_way_texting_status
normalized: /platform/v1/numbers/dedicated_numbers/set_two_way_texting_status
basePath: /platform/v1
- original: /numbers/twilio
normalized: /platform/v1/numbers/twilio
basePath: /platform/v1
- original: /numbers/twilio/{sub_account_id}
normalized: /platform/v1/numbers/twilio/{sub_account_id}
basePath: /platform/v1
- file: conversations.json
basePath: /v2
transformations:
- original: /conversations/{id}
normalized: /v2/conversations/{id}
basePath: /v2
- file: legacy_v2_communication.json
basePath: /v2
transformations:
- original: /conversations/{conversation_id}/messages
normalized: /v2/conversations/{conversation_id}/messages
basePath: /v2
- file: messages.json
basePath: /business/messaging
transformations:
- original: /v1/channels
normalized: /business/messaging/v1/channels
basePath: /business/messaging
- original: /v1/channels/typing
normalized: /business/messaging/v1/channels/typing
basePath: /business/messaging
pathConflicts: []
componentConflicts:
- type: schema
name: ErrorResponse
resolution: Renamed to ErrorResponse_communication
files:
- merged
- communication.json
- type: schema
name: ErrorResponse
resolution: Renamed to ErrorResponse_staff_notification
files:
- merged
- staff_notification.json
- type: schema
name: Response
resolution: Renamed to Response_business_phone_numbers
files:
- merged
- business_phone_numbers.json
- type: schema
name: ErrorResponse
resolution: Renamed to ErrorResponse_business_phone_numbers
files:
- merged
- business_phone_numbers.json
- type: schema
name: ErrorResponse
resolution: Renamed to ErrorResponse_activity_message
files:
- merged
- activity_message.json
- type: schema
name: Response
resolution: Renamed to Response_communication
files:
- merged
- communication.json
- type: schema
name: ErrorResponse
resolution: Renamed to ErrorResponse_conversations
files:
- merged
- conversations.json
totalPaths: 36
totalComponents: 50
servers:
- url: https://api.vcita.biz
description: Unified API Gateway server
tags:
- name: Messaging Channels
paths:
/business/messaging/v1/channels:
post:
description: '## Overview
Connecting a business to a primitive messaging channel through known providers.
**Prerequisites:**
- Business must have a valid `callsandtexting` subscription to use this endpoint.
- For businesses without the `claim_dedicated_number` feature enabled, the `voice_text_app_installed` parameter must be set to `true`.
Available for **Staff, App, and Directory tokens**.'
parameters: []
responses:
'201':
description: Success
content:
application/json:
example:
data:
channel:
business_uid: Business UID
country_code: Alpha 2 country code
number: The claimed (Nexmo)
provider: The provider
status: Number status
success: true / false
success: true
summary: Create a mesaging channel
tags:
- Messaging Channels
x-amazon-apigateway-auth:
type: NONE
x-amazon-apigateway-integration:
httpMethod: POST
responses:
default:
statusCode: '201'
type: http_proxy
uri: https:///business/messaging/v1/channels
x-auth-type: Application & Application User
requestBody:
content:
application/json:
schema:
properties:
channel:
properties:
params:
description: landline number - Not required
properties:
number:
description: landline number - Not required
type: string
type: object
provider:
description: The messaging provider. Currently only 'nexmo' is supported.
type: string
enum:
- nexmo
voice_text_app_installed:
description: Required when business does not have the `claim_dedicated_number` feature enabled. Set to `true` to indicate the voice/text app is installed.
type: boolean
type: object
type: object
security:
- Bearer: []
operationId: postBusinessMessagingV1Channels
x-operation-id-source: derived
components:
securitySchemes:
Bearer:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Provide a valid bearer token in the Authorization header. Example: ''Authorization: Bearer {app_token}'''
Conversations:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Provide a valid staff bearer token in the Authorization header. Example: ''Authorization: Bearer {staff_token}''.'
x-provenance:
method: searched
source: https://developers.intandem.tech:443/reference
harvested: '2026-11-15'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://developers.intandem.tech/reference/availablephonenumberscontroller_findall.md
- https://developers.intandem.tech/reference/businessphonenumberscontroller_create.md
- https://developers.intandem.tech/reference/businessphonenumberscontroller_findall.md
- https://developers.intandem.tech/reference/businessphonenumberscontroller_findone.md
- https://developers.intandem.tech/reference/businessphonenumberscontroller_update.md
- https://developers.intandem.tech/reference/channelscontroller_create.md
- https://developers.intandem.tech/reference/channelscontroller_deletechannel.md
- https://developers.intandem.tech/reference/channelscontroller_updatechannel.md
- https://developers.intandem.tech/reference/contactchannelscontroller_index.md
- https://developers.intandem.tech/reference/delete_platform-v1-numbers-twilio-sub-account-id.md
- https://developers.intandem.tech/reference/delete_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech/reference/get_platform-v1-clients-client-id-conversations-1.md
- https://developers.intandem.tech/reference/get_platform-v1-conversations.md
- https://developers.intandem.tech/reference/get_v2-conversations-conversation-id-messages.md
- https://developers.intandem.tech/reference/get_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech/reference/get_v3-communication-notification-templates.md
- https://developers.intandem.tech/reference/get_v3-communication-staff-notifications-uid.md
- https://developers.intandem.tech/reference/getstaffnotificationstats.md
- https://developers.intandem.tech/reference/listactivitymessages.md
- https://developers.intandem.tech/reference/liststaffnotifications.md
- https://developers.intandem.tech/reference/messagescontroller_createmessage.md
- https://developers.intandem.tech/reference/messagescontroller_updatestatus.md
- https://developers.intandem.tech/reference/post_business-messaging-v1-channels-typing.md
- https://developers.intandem.tech/reference/post_business-messaging-v1-channels.md
- https://developers.intandem.tech/reference/post_platform-v1-messages.md
- https://developers.intandem.tech/reference/post_platform-v1-numbers-dedicated-numbers-assign.md
- https://developers.intandem.tech/reference/post_platform-v1-numbers-twilio.md
- https://developers.intandem.tech/reference/post_v3-communication-notification-templates.md
- https://developers.intandem.tech/reference/post_v3-communication-staff-notifications.md
- https://developers.intandem.tech/reference/put_platform-v1-numbers-dedicated-numbers-set-two-way-texting-status.md
- https://developers.intandem.tech/reference/put_v2-conversations-id.md
- https://developers.intandem.tech/reference/put_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech/reference/quotascontroller_getquota.md
- https://developers.intandem.tech/reference/recordingscontroller_deletevoicecallrecording.md
- https://developers.intandem.tech/reference/recordingscontroller_updatevoicecallrecording.md
- https://developers.intandem.tech/reference/reportscontroller_getvoicecallstats.md
- https://developers.intandem.tech/reference/sendactivitymessage.md
- https://developers.intandem.tech/reference/sessionscontroller_createsession.md
- https://developers.intandem.tech/reference/sessionscontroller_getsession.md
- https://developers.intandem.tech/reference/sessionscontroller_logicdelete.md
- https://developers.intandem.tech/reference/sessionscontroller_updatestatus.md
- https://developers.intandem.tech/reference/sessionstypingcontroller_typingstatus.md
- https://developers.intandem.tech/reference/settingscontroller_create.md
- https://developers.intandem.tech/reference/settingscontroller_delete.md
- https://developers.intandem.tech/reference/settingscontroller_get.md
- https://developers.intandem.tech/reference/settingscontroller_update.md
- https://developers.intandem.tech/reference/transcriptcontroller_gettranscript.md
- https://developers.intandem.tech/reference/voicecallscontroller_create.md
- https://developers.intandem.tech/reference/voicecallscontroller_get.md
- https://developers.intandem.tech/reference/voicecallscontroller_getall.md
- https://developers.intandem.tech/reference/voicecallscontroller_update.md
- https://developers.intandem.tech:443/reference/availablephonenumberscontroller_findall.md
- https://developers.intandem.tech:443/reference/businessphonenumberscontroller_create.md
- https://developers.intandem.tech:443/reference/businessphonenumberscontroller_findall.md
- https://developers.intandem.tech:443/reference/businessphonenumberscontroller_findone.md
- https://developers.intandem.tech:443/reference/businessphonenumberscontroller_update.md
- https://developers.intandem.tech:443/reference/channelscontroller_create.md
- https://developers.intandem.tech:443/reference/channelscontroller_deletechannel.md
- https://developers.intandem.tech:443/reference/channelscontroller_updatechannel.md
- https://developers.intandem.tech:443/reference/contactchannelscontroller_index.md
- https://developers.intandem.tech:443/reference/delete_platform-v1-numbers-twilio-sub-account-id.md
- https://developers.intandem.tech:443/reference/delete_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech:443/reference/get_platform-v1-clients-client-id-conversations-1.md
- https://developers.intandem.tech:443/reference/get_platform-v1-conversations.md
- https://developers.intandem.tech:443/reference/get_v2-conversations-conversation-id-messages.md
- https://developers.intandem.tech:443/reference/get_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech:443/reference/get_v3-communication-notification-templates.md
- https://developers.intandem.tech:443/reference/get_v3-communication-staff-notifications-uid.md
- https://developers.intandem.tech:443/reference/getstaffnotificationstats.md
- https://developers.intandem.tech:443/reference/listactivitymessages.md
- https://developers.intandem.tech:443/reference/liststaffnotifications.md
- https://developers.intandem.tech:443/reference/messagescontroller_createmessage.md
- https://developers.intandem.tech:443/reference/messagescontroller_updatestatus.md
- https://developers.intandem.tech:443/reference/post_business-messaging-v1-channels-typing.md
- https://developers.intandem.tech:443/reference/post_business-messaging-v1-channels.md
- https://developers.intandem.tech:443/reference/post_platform-v1-messages.md
- https://developers.intandem.tech:443/reference/post_platform-v1-numbers-dedicated-numbers-assign.md
- https://developers.intandem.tech:443/reference/post_platform-v1-numbers-twilio.md
- https://developers.intandem.tech:443/reference/post_v3-communication-notification-templates.md
- https://developers.intandem.tech:443/reference/post_v3-communication-staff-notifications.md
- https://developers.intandem.tech:443/reference/put_platform-v1-numbers-dedicated-numbers-set-two-way-texting-status.md
- https://developers.intandem.tech:443/reference/put_v2-conversations-id.md
- https://developers.intandem.tech:443/reference/put_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech:443/reference/quotascontroller_getquota.md
- https://developers.intandem.tech:443/reference/recordingscontroller_deletevoicecallrecording.md
- https://developers.intandem.tech:443/reference/recordingscontroller_updatevoicecallrecording.md
- https://developers.intandem.tech:443/reference/reportscontroller_getvoicecallstats.md
- https://developers.intandem.tech:443/reference/sendactivitymessage.md
- https://developers.intandem.tech:443/reference/sessionscontroller_createsession.md
- https://developers.intandem.tech:443/reference/sessionscontroller_getsession.md
- https://developers.intandem.tech:443/reference/sessionscontroller_logicdelete.md
- https://developers.intandem.tech:443/reference/sessionscontroller_updatestatus.md
- https://developers.intandem.tech:443/reference/sessionstypingcontroller_typingstatus.md
- https://developers.intandem.tech:443/reference/settingscontroller_create.md
- https://developers.intandem.tech:443/reference/settingscontroller_delete.md
- https://developers.intandem.tech:443/reference/settingscontroller_get.md
- https://developers.intandem.tech:443/reference/settingscontroller_update.md
- https://developers.intandem.tech:443/reference/transcriptcontroller_gettranscript.md
- https://developers.intandem.tech:443/reference/voicecallscontroller_create.md
- https://developers.intandem.tech:443/reference/voicecallscontroller_get.md
- https://developers.intandem.tech:443/reference/voicecallscontroller_getall.md
- https://developers.intandem.tech:443/reference/voicecallscontroller_update.md
merge:
pages: 102
deduped: 294
conflicts_kept_first: 0