POST api/CommunicationKeys

Creates a new communication key.

Request Information

URI Parameters

None.

Body Parameters

Data to use for the new communication key.

NewCommunicationKey

Name	Description	Type	Additional information
Name	The name of the communication key.	string	Max length: 256 Min length: 1
Data	The communication key. If not specified, it will be generated.	Collection of byte	Max length: 32 Min length: 32

Name

Description

Type

Additional information

Name

The name of the communication key.

string

Max length: 256

Min length: 1

Data

The communication key. If not specified, it will be generated.

Collection of byte

Max length: 32

Min length: 32

Request Formats

application/json, text/json

Sample:

{
  "Name": "sample string 1",
  "Data": "QEA="
}

Response Information

Resource Description

CommunicationKey

Name	Description	Type	Additional information
Id	The ID of the communication key.	globally unique identifier	Required
Name	The name of the communication key.	string	Max length: 256 Min length: 1
Data	The communication key.	Collection of byte	Required Max length: 32 Min length: 32
Created	The date when the communication key was created (in the ISO 8601 format).	date	Required
Updated	The date when the communication key was updated last time (in the ISO 8601 format).	date	None.

Status Codes

All HTTP status codes must be expected, but the following status codes are the most probable:

Created (201) - The communication key is successfully added.
BadRequest (400) - The data for a new communication key is invalid.

Response Formats

application/json, text/json

Sample:

{
  "Id": "eb9ab972-9957-4c13-9437-7fbd7be9b307",
  "Name": "sample string 2",
  "Data": "QEA=",
  "Created": "2025-10-25T22:54:45.737561+00:00",
  "Updated": "2025-10-25T22:54:45.737561+00:00"
}