---
title: "Create a New API Call"
method: POST
path: "/calls/"
---

# Create a New API Call

`POST /calls/`

## Request

- Base URL: `https://client.apimetrics.io/api/2`
- URL: `https://client.apimetrics.io/api/2/calls/`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/apicontext/apis/api-settings/docs/calls/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this API to create a new API Call in your account.

## Request body

- object
  - `meta` object
    - `name` string, required: Name of the call
    - `tags` string[]: List of tags for the call
    - `description` string: Optional descriptive text for the call
  - `request` object
    - `method` string, required: HTTP method to use
    - `url` string, required: URL to call
    - `parameters` object[]: Query parameters to include in the request URL
      - `key` string, required: The key to use
      - `value` string, required: The value to use
    - `headers` object[]: List of headers to add the call
      - `key` string, required: The key to use
      - `value` string, required: The value to use
    - `body` string: Payload to send in the API call - this may need to be JSON-encoded
    - `auth_id` string: ID of the Authentication Setting to use
    - `token_id` string: ID of the Authentication Token to use

## Response `200`

200

- object
  - `meta` object
    - `domain` string
    - `description` unknown
    - `created` string
    - `tags` unknown[]
      - unknown
    - `accept` unknown
    - `last_update` string
    - `content_type` unknown
    - `owner` string
    - `name` string
  - `request` object
    - `body` unknown
    - `parameters` unknown[]
      - unknown
    - `url` string
    - `auth_id` unknown
    - `headers` unknown[]
      - unknown
    - `token_id` unknown
    - `method` string
  - `id` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/apicontext/apis/api-settings.md) - [All operations](https://skmtc.dev/apicontext/apis/api-settings/llms.txt) - [OpenAPI document](https://skmtc.dev/apicontext/apis/api-settings/revisions/2e9a62324e82?raw)