# Create an API Key

**POST /Api/Create/Key**

This process creates a new key and assigns it to manually configured acl group ids that you have access to (see api/Read/Groups). Your primary access group that allows key creation cannot be allocated to new access keys.  Only the GroupId and Display_Name key are required and the others are optional.
*Secret Hmac and Today Code Required. No Caching.*



## Servers
- https://Api.StrandVision.com/v1.0: https://Api.StrandVision.com/v1.0 ()


## Authentication methods
- Authorization key & Authorization date & Authorization hmac & Authorization today


## Parameters



### Body:  (object)

- **Display_Name** (string)
  The display name for this new key. This must be unique for all keys of this customer parent.
- **Email** (string)
  The email address of the person who created this.
- **Phone** (string)
  The phone number of the person who created this.
- **StartDate** (string)
  HTTP-formatted GMT/UTC date/time for the starting date for this key. This often matches the Created date.
- **EndDate** (string)
  HTTP-formatted GMT/UTC date/time for when this key stops functioning.  If the key is not active, this is the date it was disabled.
- **DayPass** (number)
  1 if the server day password is required (changes multiple times per day). Defaults to 0 for not required.
- **Require_Https** (number)
  Defaults to 1 for HTTPS protocol required for this key and 0 if not.
- **AllowHours** (number)
  The number of hours that the remote computer clock can be different than the server clock.  0 ignores the x-ApiDate entirely and can be skipped. Defaults to 5 minutes.
- **ResponseFormat** (string)
  The default response format that is assigned to this key. Current options are csv, json or xml and the default is json.
- **LogLevel** (number)
  The default logging level for this key. 0=minimal, 1=medium, 2+=high. Default=0.
- **LogRaw** (number)
  The number of days to allow raw log details to be stored and accessed. Default=0
- **MaxHits** (string)
  The rate limiting that is assigned to this key. See [Rate Limiting](#topic-rate-limiting) for details.
- **GroupId** (string)
  The comma separated list of API groups to assign to this key. See [/Api/Read/Groups endpoint](#operation-get-api-read-groups) for groups that can be assigned.
- **Defaults** (object)
  The defaults for this api key.


## Responses
### 200
Created API Key successfully

#### Body:  (object)
- **Id** (number)
  database id for this API Key (useful for reviewing logs)
- **Api_Key** (string)
  the api key for this record.
- **Api_Secret** (string)
  the api secret value for this record.
- **Name** (string)
  The descriptive name of the API Key setup by the user
- **MaxHits** (string)
  The rate limiting that is assigned to this key. See [Rate Limiting](#topic-rate-limiting) for details.

### 400
Bad Request - Display_Name is already defined or invalid parameter passed.

#### Body:  (string)
string

[Powered by Bump.sh](https://bump.sh)