Create skill

The POST /skills endpoint creates a new skill using the provided values.

In this page


Most URLs in the example code use the following values:

Headers

Header parameters in Requests (User Admin API) apply to this endpoint.

Authorization scopes supported:

ScopeAccess granted
users:writeEntire endpoint

Requests

Example Request

curl -L -X POST "https://***.api.newvoicemedia.com/useradmin/skills" \
-H "Content-Type: application/json" \
-H "Accept: application/vnd.newvoicemedia.v4+json" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
--data-raw "<JSON BODY>"

Request body

The endpoint requires a skill object in JSON format as in the request body.

Example body

{
  "skillName": "skill_test"
}

where:

  • skillName. The name of the skill.

Responses

Responses contain the created skill.

Successful response

Successful requests return a 200 Success code and the created skill.

Example response

{
  "skillId": "7e7ee25f-76fa-4ca8-94df-dae9c65d4df0",
  "skillName": "Skill1",
  "skillDisplayId": 12345
}

where:

  • skillId. The unique ID of the skill.
  • skillName. The name of the skill.
  • skillDisplayID. The skill's unique ID.


Try it out

  

For information, see Trying out Vonage Contact Center APIs.