---
title: "Create API key"
method: POST
path: "/api_keys"
tags: ["API Management"]
---

# Create API key

`POST /api_keys`

This endpoint allows you to create an API key with relevant permissions as per users need.
The scopes that need to included in the API need to be passed in the API call as comma seperated values.<br>
Following are the supported scopes - 

* "email.send" 
* "domain.read" 
* "domain.write"
* "suppression.write"
* "template.read"
* "template.write"
* "tags.write"
* "subaccount.read"
* "subaccount.write"
* "events"
* "logs"
* "stats"
* "apikey.read" 
* "apikey.write"
* "webhook.read"
* "webhook.write"

## Headers

- `on-behalf-of` string

## Request body

- object
  - `name` string
  - `scopes` string[]
  - `ip_address` string[]

## Response `201`

Created

- object
  - `api_key` string
  - `api_key_id` integer
  - `name` string
  - `scopes` string[]
  - `ip_address` string[]

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/netcorecloud/apis/email-api-v6.md) · [All operations](https://skmtc.dev/netcorecloud/apis/email-api-v6/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netcorecloud/email-api-v6/revisions/73f83bc2eff8/schema)