> For the complete documentation index, see [llms.txt](https://rest-api.symphony.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rest-api.symphony.com/main/uri-protocols/create-protocol.md).

# Create Protocol

## POST /v1/admin/system/protocols

> Add an entry to URI protocols supported by the company (pod)

```json
{"openapi":"3.1.1","info":{"title":"Pod API","version":"20.17.1"},"servers":[{"url":"http://yourpodURL.symphony.com/pod"}],"paths":{"/v1/admin/system/protocols":{"post":{"summary":"Add an entry to URI protocols supported by the company (pod)","parameters":[{"schema":{"type":"string"},"name":"sessionToken","description":"Session authentication token.","in":"header","required":true}],"tags":["System"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Protocol"}}}},"400":{"description":"Client error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized: Invalid session token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden: Caller lacks necessary entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Protocol"}}},"required":true,"description":"the protocol to add"}}}},"components":{"schemas":{"Protocol":{"type":"object","required":["scheme"],"properties":{"scheme":{"type":"string","description":"URI protocol scheme (example: http, https, ftp)"}}},"Error":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}}}}
```

> ### 📘 Naming
>
> The name specified for the `scheme` parameter must start with a letter, must contain only letters, numbers, dashes, dots, and plus characters, and cannot be null.

> ### ❗️ Required Permissions
>
> This endpoint may only be called by *Service User* accounts with the *User Provisioning* role.
>
> See [Bot Permissions](https://docs.developers.symphony.com/building-bots-on-symphony/configuration/bot-permissions) for a list of roles and associated privileges.