openapi-directory/api/zoomconnect.com.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","info":{"description":"The world's greatest SMS API","title":"www.zoomconnect.com","version":"1","x-apisguru-categories":["messaging","marketing"],"x-logo":{"url":"https://zoomconnect.com/assets/logo.png"},"x-origin":[{"converter":{"url":"https://github.com/lucybot/api-spec-converter","version":"2.7.31"},"format":"swagger","url":"https://www.zoomconnect.com/zoom/api-docs","version":"1.2"}],"x-providerName":"zoomconnect.com","x-tags":["SMS","bulk SMS"]},"tags":[{"description":"Core information related to your account","name":"account"},{"description":"Manage contacts","name":"contacts"},{"description":"Manage groups","name":"groups"},{"description":"Manage your messages","name":"messages"},{"description":"Send and schedule messages","name":"sms"},{"description":"Manage your templates","name":"templates"},{"description":"(BETA) Send, schedule and manage voice messages","name":"voice"}],"paths":{"/api/rest/v1/account/balance":{"get":{"deprecated":false,"description":"Returns your account's credit balance","operationId":"getBalance","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceAccount"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceAccount"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"balance","tags":["account"]}},"/api/rest/v1/account/statistics":{"get":{"deprecated":false,"description":"Returns data from the statistics report. Note that by default the statistics shown are based on the number of messages, use the calculateCreditValue should you wish to calculate the statistics based on credit value.","operationId":"getStatistics","parameters":[{"description":"date format: dd-MM-yyyy","in":"query","name":"from","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"date format: dd-MM-yyyy","in":"query","name":"to","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"optional email address of user to return statistics for a single user, default is to return statistics for all users if administrator, or statistics for your own account if not an administrator","in":"query","name":"userEmailAddress","required":false,"schema":{"type":"string"}},{"description":"optional campaign name","in":"query","name":"campaign","required":false,"schema":{"type":"string"}},{"description":"optionally include refunded and optout counts, default is false","in":"query","name":"includeRefundedAndOptout","required":false,"schema":{"type":"boolean"}},{"description":"optionally calculate using credit value rather than message count, default is false","in":"query","name":"calculateCreditValue","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceAccountStatistics"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceAccountStatistics"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"statistics","tags":["account"]}},"/api/rest/v1/account/transfer":{"post":{"deprecated":false,"description":"Transfers credits between two users in the same team. The <i>account email address</i> fields as well as the <i>number of credits to transfer</i> are required. ","operationId":"transfer","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceTransferCreditsRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceTransferCreditsRequest"}}},"description":"request"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceUser"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceUser"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"transfer","tags":["account"]}},"/api/rest/v1/account/user":{"get":{"deprecated":false,"description":"Find a user for a particular email address","operationId":"search","parameters":[{"description":"search by email address","in":"query","name":"searchEmail","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceUsers"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceUsers"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"search","tags":["account"]},"put":{"deprecated":false,"description":"Creates a new sub-account in your team. The following fields are required <i>firstname, lastname, email address, contact number</i> and <i>password.</i>","requestBody":{"$ref":"#/components/requestBodies/WebServiceUser"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceUser"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceUser"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"create","tags":["account"]}},"/api/rest/v1/account/user/{userId}":{"get":{"deprecated":false,"description":"Gets a user from a given user id","operationId":"getUser","parameters":[{"description":"userId","in":"path","name":"userId","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceUser"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceUser"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"getUser","tags":["account"]},"post":{"deprecated":false,"description":"Updates a sub-account in your team. The following fields can be updated <i>firstname, lastname, contact number</i> and <i>password.</i>","parameters":[{"description":"userId","in":"path","name":"userId","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"$ref":"#/components/requestBodies/WebServiceUser"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceUser"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceUser"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"update","tags":["account"]}},"/api/rest/v1/contacts/all":{"get":{"deprecated":false,"description":"Returns all contacts","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceContacts"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceContacts"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"all","tags":["contacts"]}},"/api/rest/v1/contacts/create":{"post":{"deprecated":false,"description":"Creates a  contact","requestBody":{"$ref":"#/components/requestBodies/WebServiceContact"},"responses":{"200":{"description":"No response was specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceContact"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceContact"}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceContact"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceContact"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"create","tags":["contacts"]}},"/api/rest/v1/contacts/{contactId}":{"delete":{"deprecated":false,"description":"Deletes a  contact","parameters":[{"description":"contactId","in":"path","name":"contactId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified"},"204":{"description":"No Content"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"summary":"delete","tags":["contacts"]},"get":{"deprecated":false,"description":"Returns details for a single contact","parameters":[{"description":"contactId","in":"path","name":"contactId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceContact"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceContact"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"get","tags":["contacts"]},"post":{"deprecated":false,"description":"Updates a  contact","parameters":[{"description":"contactId","in":"path","name":"contactId","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/WebServiceContact"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceContact"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceContact"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"update","tags":["contacts"]}},"/api/rest/v1/contacts/{contactId}/addFromGroup/{groupId}":{"get":{"deprecated":false,"description":"Remove a contact from a group","parameters":[{"description":"contactId","in":"path","name":"contactId","required":true,"schema":{"type":"string"}},{"description":"groupId","in":"path","name":"groupId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"removeFromGroup","tags":["contacts"]},"post":{"deprecated":false,"description":"Remove a contact from a group","parameters":[{"description":"contactId","in":"path","name":"contactId","required":true,"schema":{"type":"string"}},{"description":"groupId","in":"path","name":"groupId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified"},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"removeFromGroup","tags":["contacts"]}},"/api/rest/v1/contacts/{contactId}/addToGroup/{groupId}":{"get":{"deprecated":false,"description":"Add a contact to a group","parameters":[{"description":"contactId","in":"path","name":"contactId","required":true,"schema":{"type":"string"}},{"description":"groupId","in":"path","name":"groupId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"addToGroup","tags":["contacts"]},"post":{"deprecated":false,"description":"Add a contact to a group","parameters":[{"description":"contactId","in":"path","name":"contactId","required":true,"schema":{"type":"string"}},{"description":"groupId","in":"path","name":"groupId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified"},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"addToGroup","tags":["contacts"]}},"/api/rest/v1/groups/all":{"get":{"deprecated":false,"description":"Returns all groups","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceGroups"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceGroups"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"all","tags":["groups"]}},"/api/rest/v1/groups/create":{"post":{"deprecated":false,"description":"Create a  group","requestBody":{"$ref":"#/components/requestBodies/WebServiceGroup"},"responses":{"200":{"description":"No response was specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceGroup"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceGroup"}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceGroup"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceGroup"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"create","tags":["groups"]}},"/api/rest/v1/groups/{groupId}":{"delete":{"deprecated":false,"description":"Deletes a  group","parameters":[{"description":"groupId","in":"path","name":"groupId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified"},"204":{"description":"No Content"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"summary":"delete","tags":["groups"]},"get":{"deprecated":false,"description":"Returns details for a single group","parameters":[{"description":"groupId","in":"path","name":"groupId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceGroup"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceGroup"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"get","tags":["groups"]},"post":{"deprecated":false,"description":"Update a  group","parameters":[{"description":"groupId","in":"path","name":"groupId","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/WebServiceGroup"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceGroup"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceGroup"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"update","tags":["groups"]}},"/api/rest/v1/groups/{groupId}/addContact/{contactId}":{"get":{"deprecated":false,"description":"Add a contact to a group","parameters":[{"description":"groupId","in":"path","name":"groupId","required":true,"schema":{"type":"string"}},{"description":"contactId","in":"path","name":"contactId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"addContact","tags":["groups"]},"post":{"deprecated":false,"description":"Add a contact to a group","parameters":[{"description":"groupId","in":"path","name":"groupId","required":true,"schema":{"type":"string"}},{"description":"contactId","in":"path","name":"contactId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified"},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"addContact","tags":["groups"]}},"/api/rest/v1/groups/{groupId}/removeContact/{contactId}":{"get":{"deprecated":false,"description":"Remove a contact from a group","parameters":[{"description":"groupId","in":"path","name":"groupId","required":true,"schema":{"type":"string"}},{"description":"contactId","in":"path","name":"contactId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"removeContact","tags":["groups"]},"post":{"deprecated":false,"description":"Remove a contact from a group","parameters":[{"description":"groupId","in":"path","name":"groupId","required":true,"schema":{"type":"string"}},{"description":"contactId","in":"path","name":"contactId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified"},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"removeContact","tags":["groups"]}},"/api/rest/v1/messages/all":{"get":{"deprecated":false,"description":"Returns all messages","parameters":[{"description":"number of elements to return at a time","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":100}},{"description":"page number","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"filter by message type","in":"query","name":"type","required":false,"schema":{"type":"string","enum":["OUTBOUND","INBOUND"]}},{"description":"filter by message status","in":"query","name":"status","required":false,"schema":{"type":"string","enum":["SCHEDULED","UNKNOWN","SENT","FAILED","FAILED_REFUNDED","FAILED_OPTOUT","DELIVERED"]}},{"description":"date format: yyyyMMdd","in":"query","name":"fromDateTimeSent","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"date format: yyyyMMdd","in":"query","name":"toDateTimeSent","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"date format: yyyyMMdd","in":"query","name":"fromDateTimeReceived","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"date format: yyyyMMdd","in":"query","name":"toDateTimeReceived","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"phone number the message was sent from","in":"query","name":"fromNumber","required":false,"schema":{"type":"string"}},{"description":"phone number the message was sent to","in":"query","name":"toNumber","required":false,"schema":{"type":"string"}},{"description":"search matching message text","in":"query","name":"message","required":false,"schema":{"type":"string"}},{"description":"search by campaign","in":"query","name":"campaign","required":false,"schema":{"type":"string"}},{"description":"search by data field","in":"query","name":"dataField","required":false,"schema":{"type":"string"}},{"description":"return only deleted / not deleted messages","in":"query","name":"deleted","required":false,"schema":{"type":"boolean"}},{"description":"return only read / unread messages (inbox messages only)","in":"query","name":"read","required":false,"schema":{"type":"boolean"}},{"description":"return only inbox messages which are a reply to the message with the given message id","in":"query","name":"repliesToMessageId","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceMessages"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceMessages"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"all","tags":["messages"]}},"/api/rest/v1/messages/analyse/full":{"post":{"deprecated":false,"description":"Returns full analysis of message","operationId":"analyse-full","requestBody":{"$ref":"#/components/requestBodies/WebServiceAnalyseMessageRequestMessageAndRecipientNumber"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceAnalyseMessageResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceAnalyseMessageResponse"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"analyse-full","tags":["messages"]}},"/api/rest/v1/messages/analyse/message-credit-cost":{"post":{"deprecated":false,"description":"Returns the number of credit which would be required to send the request message to the requested recipient number","operationId":"analyse-message-credit-cost","requestBody":{"$ref":"#/components/requestBodies/WebServiceAnalyseMessageRequestMessageAndRecipientNumber"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"format":"double","type":"number"}},"application/xml":{"schema":{"format":"double","type":"number"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"analyse-message-credit-cost","tags":["messages"]}},"/api/rest/v1/messages/analyse/message-encoding":{"post":{"deprecated":false,"description":"Returns the message encoding that would be required to send the requested message","operationId":"analyse-message-encoding","requestBody":{"$ref":"#/components/requestBodies/WebServiceAnalyseMessageRequestMessageOnly"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"type":"string"}},"application/xml":{"schema":{"type":"string"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"analyse-message-encoding","tags":["messages"]}},"/api/rest/v1/messages/analyse/message-length":{"post":{"deprecated":false,"description":"Returns the number of characters the requested message consists of","operationId":"analyse-message-length","requestBody":{"$ref":"#/components/requestBodies/WebServiceAnalyseMessageRequestMessageOnly"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"format":"int32","type":"integer"}},"application/xml":{"schema":{"format":"int32","type":"integer"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"analyse-message-length","tags":["messages"]}},"/api/rest/v1/messages/analyse/message-length-within-max-allowed":{"post":{"deprecated":false,"description":"Returns details for a single message","operationId":"analyse-","requestBody":{"$ref":"#/components/requestBodies/WebServiceAnalyseMessageRequestMessageOnly"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"type":"boolean"}},"application/xml":{"schema":{"type":"boolean"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"analyse-","tags":["messages"]}},"/api/rest/v1/messages/analyse/number-of-messages":{"post":{"deprecated":false,"description":"Returns the number of SMS parts which would be sent when sending the requested message","operationId":"analyse-number-of-messages","requestBody":{"$ref":"#/components/requestBodies/WebServiceAnalyseMessageRequestMessageOnly"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"format":"int32","type":"integer"}},"application/xml":{"schema":{"format":"int32","type":"integer"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"analyse-number-of-messages","tags":["messages"]}},"/api/rest/v1/messages/{messageId}":{"delete":{"deprecated":false,"description":"Deletes a  message","parameters":[{"description":"messageId","in":"path","name":"messageId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified"},"204":{"description":"No Content"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"summary":"delete","tags":["messages"]},"get":{"deprecated":false,"description":"Returns details for a single message","parameters":[{"description":"messageId","in":"path","name":"messageId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceMessage"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceMessage"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"get","tags":["messages"]}},"/api/rest/v1/messages/{messageId}/markRead":{"post":{"deprecated":false,"description":"Marks a  message as read","parameters":[{"description":"messageId","in":"path","name":"messageId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceMessage"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceMessage"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"markRead","tags":["messages"]},"put":{"deprecated":false,"description":"Marks a  message as read","parameters":[{"description":"messageId","in":"path","name":"messageId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceMessage"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceMessage"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"markRead","tags":["messages"]}},"/api/rest/v1/messages/{messageId}/markUnread":{"post":{"deprecated":false,"description":"Marks a  message as unread","parameters":[{"description":"messageId","in":"path","name":"messageId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceMessage"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceMessage"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"markUnread","tags":["messages"]},"put":{"deprecated":false,"description":"Marks a  message as unread","parameters":[{"description":"messageId","in":"path","name":"messageId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceMessage"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceMessage"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"markUnread","tags":["messages"]}},"/api/rest/v1/sms/send":{"get":{"deprecated":false,"description":"Returns an example of the data to POST to send a single message.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsRequest"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"send","tags":["sms"]},"post":{"deprecated":false,"description":"Sends a single message. The <i>recipientNumber</i> and <i>message</i> fields are required. All other fields are optional.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsRequest"}}},"description":"request"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsResponse"}}}},"201":{"description":"Created"},"400":{"description":"Validation error</br></br>Code and message:<ul><li>2 - Invalid mobile number</li><li>3 - Message cannot be empty</li></ul>","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestErrorDTO"}},"application/xml":{"schema":{"$ref":"#/components/schemas/RestErrorDTO"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"send","tags":["sms"]}},"/api/rest/v1/sms/send-bulk":{"get":{"deprecated":false,"description":"Returns an example of the data to POST to send multiple messages in one transaction.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsRequests"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsRequests"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"send-bulk","tags":["sms"]},"post":{"deprecated":false,"description":"Send multiple messages in one transaction.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsRequests"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsRequests"}}},"description":"requests"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsResponses"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceSendSmsResponses"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"send-bulk","tags":["sms"]}},"/api/rest/v1/sms/send-url-parameters":{"get":{"deprecated":false,"description":"Send a single message using URL parameters.The <i>recipientNumber</i> and <i>message</i> parameters are required. All other parameters are optional.","parameters":[{"description":"the phone number of the recipient to send to","in":"query","name":"recipientNumber","required":true,"schema":{"type":"string"}},{"description":"the message to send","in":"query","name":"message","required":true,"schema":{"type":"string"}},{"description":"date format: yyyyMMddHHmm","in":"query","name":"dateToSend","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"optional campaign name","in":"query","name":"campaign","required":false,"schema":{"type":"string"}},{"description":"optional extra data","in":"query","name":"dataField","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}},"application/xml":{"schema":{"type":"string"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"send-url-parameters","tags":["sms"]},"post":{"deprecated":false,"description":"Send a single message using URL parameters.The <i>recipientNumber</i> and <i>message</i> parameters are required. All other parameters are optional.","parameters":[{"description":"the phone number of the recipient to send to","in":"query","name":"recipientNumber","required":true,"schema":{"type":"string"}},{"description":"the message to send","in":"query","name":"message","required":true,"schema":{"type":"string"}},{"description":"date format: yyyyMMddHHmm","in":"query","name":"dateToSend","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"optional campaign name","in":"query","name":"campaign","required":false,"schema":{"type":"string"}},{"description":"optional extra data","in":"query","name":"dataField","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"type":"string"}},"application/xml":{"schema":{"type":"string"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"send-url-parameters","tags":["sms"]}},"/api/rest/v1/sms/send-url/{token}":{"get":{"deprecated":false,"description":"Send a single message using your unique URL without having to authenticate using your email address or REST API token. The token required is the URL Sending token available on the developer setting page. The <i>recipientNumber</i> and <i>message</i> parameters are required. All other parameters are optional. Not that the token required here is ","parameters":[{"description":"token","in":"path","name":"token","required":true,"schema":{"type":"string"}},{"description":"the phone number of the recipient to send to","in":"query","name":"recipientNumber","required":true,"schema":{"type":"string"}},{"description":"the message to send","in":"query","name":"message","required":true,"schema":{"type":"string"}},{"description":"date format: yyyyMMddHHmm","in":"query","name":"dateToSend","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"optional campaign name","in":"query","name":"campaign","required":false,"schema":{"type":"string"}},{"description":"optional extra data","in":"query","name":"dataField","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}},"application/xml":{"schema":{"type":"string"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"send-url","tags":["sms"]},"post":{"deprecated":false,"description":"Send a single message using your unique URL without having to authenticate using your email address or REST API token. The token required is the URL Sending token available on the developer setting page. The <i>recipientNumber</i> and <i>message</i> parameters are required. All other parameters are optional. Not that the token required here is ","parameters":[{"description":"token","in":"path","name":"token","required":true,"schema":{"type":"string"}},{"description":"the phone number of the recipient to send to","in":"query","name":"recipientNumber","required":true,"schema":{"type":"string"}},{"description":"the message to send","in":"query","name":"message","required":true,"schema":{"type":"string"}},{"description":"date format: yyyyMMddHHmm","in":"query","name":"dateToSend","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"optional campaign name","in":"query","name":"campaign","required":false,"schema":{"type":"string"}},{"description":"optional extra data","in":"query","name":"dataField","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"type":"string"}},"application/xml":{"schema":{"type":"string"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"send-url","tags":["sms"]}},"/api/rest/v1/templates/all":{"get":{"deprecated":false,"description":"Returns all templates","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceTemplates"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceTemplates"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"all","tags":["templates"]}},"/api/rest/v1/templates/{templateId}":{"delete":{"deprecated":false,"description":"Deletes a  template","parameters":[{"description":"templateId","in":"path","name":"templateId","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Description was not specified"},"204":{"description":"No Content"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"summary":"delete","tags":["templates"]},"get":{"deprecated":false,"description":"Returns details for a single template","parameters":[{"description":"templateId","in":"path","name":"templateId","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceTemplate"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceTemplate"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"get","tags":["templates"]}},"/api/rest/v1/voice/all":{"get":{"deprecated":false,"description":"Returns all voice messages","parameters":[{"description":"number of elements to return at a time","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":100}},{"description":"page number","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"filter by message status","in":"query","name":"status","required":false,"schema":{"type":"string","enum":["SCHEDULED","UNKNOWN","SENT","FAILED","FAILED_REFUNDED","FAILED_OPTOUT","DELIVERED"]}},{"description":"date format: yyyyMMdd","in":"query","name":"fromDateTimeSent","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"date format: yyyyMMdd","in":"query","name":"toDateTimeSent","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"phone number the message was sent to","in":"query","name":"toNumber","required":false,"schema":{"type":"string"}},{"description":"search matching message text","in":"query","name":"message","required":false,"schema":{"type":"string"}},{"description":"search by campaign","in":"query","name":"campaign","required":false,"schema":{"type":"string"}},{"description":"search by data field","in":"query","name":"dataField","required":false,"schema":{"type":"string"}},{"description":"return only deleted / not deleted messages","in":"query","name":"deleted","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceVoiceMessages"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceVoiceMessages"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"all","tags":["voice"]}},"/api/rest/v1/voice/single-audio":{"post":{"deprecated":false,"description":"Send a single audio voice message to one recipient. Note, Content-Type header must be set to multipart/form-data for this request.","operationId":"single-audio","parameters":[{"description":"the phone number of the recipient to send to","in":"query","name":"recipientNumber","required":true,"schema":{"type":"string"}},{"description":"optional campaign name","in":"query","name":"campaign","required":false,"schema":{"type":"string"}},{"description":"optional extra data","in":"query","name":"dataField","required":false,"schema":{"type":"string"}},{"description":"optional number of times to retry unanswered call","in":"query","name":"retryCount","required":false,"schema":{"type":"integer","format":"int32"}},{"description":"optional minimum interval in minutes between retry attempts","in":"query","name":"retryMinimumInterval","required":false,"schema":{"type":"integer","format":"int32"}},{"description":"optional maximum interval in minutes between retry attempts","in":"query","name":"retryMaximumInterval","required":false,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"description":"audio file to play, supports MP3 or WAV format","type":"string","format":"binary"}},"required":["file"]}}},"required":true},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceSendVoiceMessageResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceSendVoiceMessageResponse"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"single-audio","tags":["voice"]}},"/api/rest/v1/voice/single-text":{"post":{"deprecated":false,"description":"Send a single text voice message to one recipient","operationId":"single-text","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceVoiceMessageSendSingleTextRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceVoiceMessageSendSingleTextRequest"}}},"description":"request"},"responses":{"200":{"description":"Description was not specified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceSendVoiceMessageResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceSendVoiceMessageResponse"}}}},"201":{"description":"Created"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"single-text","tags":["voice"]}},"/api/rest/v1/voice/{messageId}":{"delete":{"deprecated":false,"description":"Deletes a  message","parameters":[{"description":"messageId","in":"path","name":"messageId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Description was not specified"},"204":{"description":"No Content"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"summary":"delete","tags":["voice"]},"get":{"deprecated":false,"description":"Returns details for a single message","parameters":[{"description":"messageId","in":"path","name":"messageId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceVoiceMessage"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceVoiceMessage"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}},"summary":"get","tags":["voice"]}}},"servers":[{"url":"https://www.zoomconnect.com/app"}],"components":{"requestBodies":{"WebServiceContact":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceContact"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceContact"}}},"description":"webServiceContact"},"WebServiceUser":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceUser"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceUser"}}},"description":"request"},"WebServiceAnalyseMessageRequestMessageAndRecipientNumber":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceAnalyseMessageRequestMessageAndRecipientNumber"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceAnalyseMessageRequestMessageAndRecipientNumber"}}},"description":"request"},"WebServiceGroup":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceGroup"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceGroup"}}},"description":"webServiceGroup"},"WebServiceAnalyseMessageRequestMessageOnly":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebServiceAnalyseMessageRequestMessageOnly"}},"application/xml":{"schema":{"$ref":"#/components/schemas/WebServiceAnalyseMessageRequestMessageOnly"}}},"description":"request"}},"securitySchemes":{"email":{"in":"header","name":"email","type":"apiKey"},"token":{"in":"header","name":"token","type":"apiKey"}},"schemas":{"Link":{"properties":{"href":{"type":"string"},"rel":{"type":"string"},"templated":{"type":"boolean"}}},"RestErrorDTO":{"description":"RestErrorDTO","properties":{"code":{"format":"int32","type":"integer"},"developerMessage":{"type":"string"},"message":{"type":"string"},"moreInfoUrl":{"type":"string"},"status":{"type":"string"}}},"Void":{},"WebServiceAccount":{"description":"WebServiceAccount","properties":{"creditBalance":{"format":"double","type":"number"},"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"}}},"WebServiceAccountStatistics":{"description":"WebServiceAccountStatistics","properties":{"from":{"format":"date-time","type":"string"},"grandTotal":{"$ref":"#/components/schemas/WebServiceStatistics"},"showingCreditValue":{"type":"boolean"},"to":{"format":"date-time","type":"string"},"users":{"items":{"$ref":"#/components/schemas/WebServiceUserStatistics"},"type":"array"}}},"WebServiceAnalyseMessageRequestMessageAndRecipientNumber":{"description":"WebServiceAnalyseMessageRequest","properties":{"message":{"type":"string"},"recipientNumber":{"type":"string"}}},"WebServiceAnalyseMessageRequestMessageOnly":{"description":"WebServiceAnalyseMessageRequest","properties":{"message":{"type":"string"},"recipientNumber":{"type":"string"}}},"WebServiceAnalyseMessageResponse":{"description":"WebServiceAnalyseMessageResponse","properties":{"characterAnalysis":{"items":{"items":{},"type":"array"},"type":"array"},"messageCreditCost":{"format":"double","type":"number"},"messageEncoding":{"type":"string"},"messageLength":{"format":"int32","type":"integer"},"messageLengthWithinMaximumAllowed":{"type":"boolean"},"numberOfMessages":{"format":"int32","type":"integer"}}},"WebServiceCampaignStatistics":{"description":"WebServiceCampaignStatistics","properties":{"campaign":{"type":"string"},"statistics":{"$ref":"#/components/schemas/WebServiceStatistics"}}},"WebServiceContact":{"description":"WebServiceContact","properties":{"contactId":{"type":"string"},"contactNumber":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"},"title":{"type":"string"}}},"WebServiceContactLink":{"description":"WebServiceContactLink","properties":{"contactId":{"type":"string"},"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"}}},"WebServiceContacts":{"description":"WebServiceContacts","properties":{"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"},"webServiceContacts":{"items":{"$ref":"#/components/schemas/WebServiceContact"},"type":"array"}}},"WebServiceGroup":{"description":"WebServiceGroup","properties":{"groupId":{"type":"string"},"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"},"name":{"type":"string"}}},"WebServiceGroups":{"description":"WebServiceGroups","properties":{"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"},"webServiceGroups":{"items":{"$ref":"#/components/schemas/WebServiceGroup"},"type":"array"}}},"WebServiceMessage":{"description":"WebServiceMessage","properties":{"campaign":{"type":"string"},"contact":{"$ref":"#/components/schemas/WebServiceContactLink"},"creditCost":{"format":"double","type":"number"},"dateTimeReceived":{"format":"date-time","type":"string"},"dateTimeScheduled":{"format":"date-time","type":"string"},"dateTimeSent":{"format":"date-time","type":"string"},"deleted":{"type":"boolean"},"fromNumber":{"type":"string"},"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"},"message":{"type":"string"},"messageId":{"type":"string"},"messageStatus":{"type":"string"},"messageType":{"type":"string"},"numberOfMessages":{"format":"int32","type":"integer"},"read":{"type":"boolean"},"repliedToMessage":{"$ref":"#/components/schemas/WebServiceMessageLink"},"toNumber":{"type":"string"},"userDataField":{"type":"string"}}},"WebServiceMessageLink":{"description":"WebServiceMessageLink","properties":{"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"},"messageId":{"type":"string"}}},"WebServiceMessages":{"description":"WebServiceMessages","properties":{"elements":{"format":"int32","type":"integer"},"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"},"page":{"format":"int32","type":"integer"},"pageSize":{"format":"int32","type":"integer"},"totalElements":{"format":"int64","type":"integer"},"totalPages":{"format":"int32","type":"integer"},"webServiceMessages":{"items":{"$ref":"#/components/schemas/WebServiceMessage"},"type":"array"}}},"WebServiceSendSmsRequest":{"description":"WebServiceSendSmsRequest","properties":{"campaign":{"type":"string"},"dataField":{"type":"string"},"dateToSend":{"format":"date-time","type":"string"},"message":{"type":"string"},"recipientNumber":{"type":"string"}}},"WebServiceSendSmsRequests":{"description":"WebServiceSendSmsRequests","properties":{"defaultDateToSend":{"format":"date-time","type":"string"},"messagesPerMinute":{"format":"int32","type":"integer"},"sendSmsRequests":{"items":{"$ref":"#/components/schemas/WebServiceSendSmsRequest"},"type":"array"}}},"WebServiceSendSmsResponse":{"description":"WebServiceSendSmsResponse","properties":{"error":{"type":"string"},"messageId":{"type":"string"}}},"WebServiceSendSmsResponses":{"description":"WebServiceSendSmsResponses","properties":{"sendSmsResponses":{"items":{"$ref":"#/components/schemas/WebServiceSendSmsResponse"},"type":"array"}}},"WebServiceSendVoiceMessageResponse":{"description":"WebServiceSendVoiceMessageResponse","properties":{"error":{"type":"string"},"voiceMessageId":{"type":"string"}}},"WebServiceStatistics":{"description":"WebServiceStatistics","properties":{"delivered":{"format":"double","type":"number"},"failed":{"format":"double","type":"number"},"failedOptout":{"format":"double","type":"number"},"failedRefunded":{"format":"double","type":"number"},"sent":{"format":"double","type":"number"},"total":{"format":"double","type":"number"}}},"WebServiceTemplate":{"description":"WebServiceTemplate","properties":{"data":{"type":"strin