Add disposition

Reading Time: 1 minute

Add a new disposition to a specified record.

Method POST
Resource https://[customer][projectid]/records/[numberid]/dispositions
Options N/A
Body Disposition object, encoded in JSON.
Body Results whether the request is succeeded or not.


Resource parameters

Name Type Mandatory Comment
customer string yes Your call centre’s unique identifier (subdomain).
numberid integer yes Unique record identifier.
projectid integer yes Unique project identifier.

Request object

Name Type Mandatory Comment
avoid_in_call bool no Ignores all records being handled by agents (prework, in call, afterwork).
description string no Description added by the supervisor.
dispositionid string yes Unique disposition identifier.
next_calldate string no If call-back or shared call-back type dispositions are set, this is the next time the record is due to be called, in YYYY-MM-DD hh-mm-ss format.
next_contactid string no Defines which phone field should be called next time (e.g.: next_contactid:2, that means phone2 will be called)
userid string yes User’s unique identifier, to whom the disposition is linked.
sendDispositionMessages boolean no If SMS and/or email sending is set up for the disposition, the SMS and/or email will be sent. Values: true, false


Response body is empty if it is successful.



Request body

    "dispositionid": "1",
    "userid": "17",
    "next_calldate": "2017-01-17 11:00:00",
    "next_contactid": "2",
    "description": "University degree",
    "avoid_in_call": true

Response body

    "errors": [],
    "response": true

There are no comments yet.
Subscribe to our newsletter
or Contact us!
Please note that by subscribing to our newsletter, you agree to receive regular email messages from VCC Live® about service related news and updates. By subscribing to our newsletter, you also agree that VCC Live® will use your data in accordance with the applicable Privacy Policy until you unsubscribe from the newsletter.

Privacy Settings Center


Necessary cookies are essential in order to navigate around a website and use its basic features. You must accept these cookies as the website cannot function properly without them.



Marketing cookies are used to track visitors across websites and deliver advertisements that are more relevant and engaging to you.



Statistic cookies collect data to help us understand how visitors use our websites and are used to improve the user experience. These cookies don’t collect personal information and cannot identify visitors.



Other cookies are those cookies that do not fall into the categories above. These cookies are in the process of being classified.