JSON API » conferences » conferences/notifications/create

Adds a notification to a conference.

Input parameters

Requires authentication and the user role privilege.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
conferenceIntegerID of conference.Yes, unless code is specified.0
codeStringCode of conference.Yes, unless conference is specified.Empty string.
destinationStringThe number or email address to notify.Yes
levelStringThe conference access for numbers. "admin", "talk", or "listen".Yes
typeString"email" or "number".Yes
validationInteger1 to validate input then return, 0 for full action.No0

Specify conference or code, but not both.

Responses

CodeDescription
201Input passed validation. Only returned if validation=1.
204Success.
400Invalid input parameters specified. Check the key and message fields for more details.
401The authentication details provided are invalid.
402Your role does not allow this.
404The conference does not exist, or you do not have permission to view it.

Data returned

No data is returned.

Example: With required parameters

http://enswitch.example.com/api/json/conferences/notifications/create/?auth_username=user;auth_password=password;conference=123;type=number;destination=2125551234;level=talk

{ "responses":[ { "code":"204", "key":"", "message":"OK" } ] }

Change history

VersionChanges
3.13Function added.