---
title: "Create an API Application"
method: POST
path: "/v1/apps"
tags: ["API and Webhooks"]
---

# Create an API Application

`POST /v1/apps`

This endpoint will create a new API Application on your Fire account with your chosen specified permissions. Please note that if there is no batch approval permissions included, the approval fields must be set to null. You will need to enable PERM_BUSINESS_POST_APPS to use this endpoint.

## Request body

- NewApiApplication
  - `applicationName` string — A name for the API Application to help you identify it
  - `numberOfPaymentApprovalsRequired` integer — Number of approvals required to process a payment in a batch
  - `numberOfPayeeApprovalsRequired` integer — Number of approvals required to create a payee in a batch
  - `isPayeeCheckEnabled` boolean — This is whether or not Verfication of Payee checks are required for SEPA payments before a batch can be submitted.
  - `permissions` string[] — The list of permissions required

## Response `201`

API Application created successfully

- AppCreated
  - `clientId` string — This is the ID of client associated with the application
  - `refreshToken` string — This is the refresh token associated with the application
  - `clientKey` string — The Client Key of the new API Application

## Other responses

- `400` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.
- `401` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.
- `403` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.

---

[API](https://skmtc.net/firefinancialservices/apis/fire-financial-services-business-api.md) · [All operations](https://skmtc.net/firefinancialservices/apis/fire-financial-services-business-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefinancialservices/fire-financial-services-business-api/revisions/1d19896d095c/schema)