# Create app > For the complete documentation index, see [llms.txt](/docs/llms.txt). POST https://admin-api.alchemy.com/v1/apps Creates a new application with the specified name, network allowlist, and optional description and products. Returns the created app with its generated API keys and configured chain network endpoints. Reference: https://www.alchemy.com/docs/tutorials/tools/admin-api/admin-api-endpoints/create-app ## Headers | Name | Type | Required | Description | |------|------|----------|-------------| | Authorization | string | Yes | Bearer authentication token | ## Code Examples ### cURL ```bash curl --request POST \ --url https://admin-api.alchemy.com/v1/apps \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "name": "string", "description": "string", "networkAllowlist": [ "string" ], "products": [ "node-api" ] }' ``` ### JavaScript ```javascript const options = { method: 'POST', headers: {'Content-Type': 'application/json', Authorization: 'Bearer '}, body: JSON.stringify({ name: 'string', description: 'string', networkAllowlist: ['string'], products: ['node-api'] }) }; fetch('https://admin-api.alchemy.com/v1/apps', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err)); ``` ### Python ```python import requests url = "https://admin-api.alchemy.com/v1/apps" payload = { "name": "string", "description": "string", "networkAllowlist": ["string"], "products": ["node-api"] } headers = { "Content-Type": "application/json", "Authorization": "Bearer " } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ### Go ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://admin-api.alchemy.com/v1/apps" payload := strings.NewReader("{\n \"name\": \"string\",\n \"description\": \"string\",\n \"networkAllowlist\": [\n \"string\"\n ],\n \"products\": [\n \"node-api\"\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` ### Java ```java HttpResponse response = Unirest.post("https://admin-api.alchemy.com/v1/apps") .header("Content-Type", "application/json") .header("Authorization", "Bearer ") .body("{\n \"name\": \"string\",\n \"description\": \"string\",\n \"networkAllowlist\": [\n \"string\"\n ],\n \"products\": [\n \"node-api\"\n ]\n}") .asString(); ``` ### C# ```csharp using RestSharp; var options = new RestClientOptions("https://admin-api.alchemy.com/v1/apps"); var client = new RestClient(options); var request = new RestRequest(""); request.AddHeader("Authorization", "Bearer "); request.AddJsonBody("{\n \"name\": \"string\",\n \"description\": \"string\",\n \"networkAllowlist\": [\n \"string\"\n ],\n \"products\": [\n \"node-api\"\n ]\n}", false); var response = await client.PostAsync(request); Console.WriteLine("{0}", response.Content); ``` ## Operation Specification ```yaml path: /v1/apps method: POST operation: operationId: CreateApp responses: '201': description: Created new app content: application/json: schema: description: |- Standard API response wrapper. All API responses are wrapped in this format for consistency. properties: data: properties: id: type: string description: App ID name: type: string description: Display name description: type: string description: Description apiKey: type: string description: API key to access chain network webhookApiKey: type: string description: API key used to access webhook's management API chainNetworks: items: properties: name: type: string description: Display name id: type: string description: Alchemy chain network id in the form of `{chain}_{network}` (e.g. `ETH_MAINNET`) networkChainId: type: string nullable: true description: EIP-155 network chain id when available. Null for non-EVM chains. rpcUrl: type: string description: HTTPS RPC endpoint wsUrl: type: string description: WebSocket endpoint grpcUrl: type: string description: gRPC endpoint (when available, e.g. Solana) required: - name - id - rpcUrl type: object additionalProperties: false type: array description: Networks configured for this app products: items: enum: - node-api - nft-api - swaps-api - block-timestamp-api - token-api - transfers-api - bundler-api - debug-api - embedded-accounts - gas-manager-api - trace-api - prices-api - transaction-simulation-api - transaction-receipts-api - user-operations-api - smart-websockets - webhooks - grpc type: string type: array description: Products enabled for this app addressAllowlist: items: properties: name: type: string description: Label for the allowlist entry. example: Primary value: type: string description: Wallet address value. example: '0x0000000000000000000000000000000000000001' required: - value type: object additionalProperties: false type: array description: Address allowlist entries for this app originAllowlist: items: properties: name: type: string description: Label for the allowlist entry. example: Primary value: type: string description: Origin value. Accepts full URLs or bare domains. example: https://example.com required: - value type: object additionalProperties: false type: array description: Origin allowlist entries for this app ipAllowlist: items: properties: name: type: string description: Label for the allowlist entry. example: Office value: type: string description: IP address or CIDR range. example: 203.0.113.1 required: - value type: object additionalProperties: false type: array description: IP allowlist entries for this app createdAt: type: string description: Creation timestamp (ISO 8601) required: - id - name - apiKey - webhookApiKey - chainNetworks - products - addressAllowlist - originAllowlist - ipAllowlist - createdAt type: object additionalProperties: false required: - data type: object additionalProperties: false '400': description: Invalid input content: application/json: schema: description: |- Standard error response wrapper. All error responses are wrapped in this format for consistency. properties: error: properties: message: type: string code: anyOf: - type: integer format: int32 - enum: - 500 - 400 - 401 - 403 - 404 - 200 - 201 - 1000 type: number status: type: integer format: int32 context: description: Additional information about the error specific to the endpoint. properties: {} type: object additionalProperties: {} required: - message - code - status type: object additionalProperties: false required: - error type: object additionalProperties: false examples: Example 1: value: error: code: 400 status: 400 message: Invalid input '401': description: Requires authentication content: application/json: schema: description: |- Standard error response wrapper. All error responses are wrapped in this format for consistency. properties: error: properties: message: type: string code: anyOf: - type: integer format: int32 - enum: - 500 - 400 - 401 - 403 - 404 - 200 - 201 - 1000 type: number status: type: integer format: int32 context: description: Additional information about the error specific to the endpoint. properties: {} type: object additionalProperties: {} required: - message - code - status type: object additionalProperties: false required: - error type: object additionalProperties: false examples: Example 1: value: error: code: 401 status: 401 message: Requires authentication '403': description: Forbidden content: application/json: schema: description: |- Standard error response wrapper. All error responses are wrapped in this format for consistency. properties: error: properties: message: type: string code: anyOf: - type: integer format: int32 - enum: - 500 - 400 - 401 - 403 - 404 - 200 - 201 - 1000 type: number status: type: integer format: int32 context: description: Additional information about the error specific to the endpoint. properties: {} type: object additionalProperties: {} required: - message - code - status type: object additionalProperties: false required: - error type: object additionalProperties: false examples: Example 1: value: error: code: 403 status: 403 message: Forbidden '409': description: App name already exists content: application/json: schema: description: |- Standard error response wrapper. All error responses are wrapped in this format for consistency. properties: error: properties: message: type: string code: anyOf: - type: integer format: int32 - enum: - 500 - 400 - 401 - 403 - 404 - 200 - 201 - 1000 type: number status: type: integer format: int32 context: description: Additional information about the error specific to the endpoint. properties: {} type: object additionalProperties: {} required: - message - code - status type: object additionalProperties: false required: - error type: object additionalProperties: false examples: Example 1: value: error: code: 1000 status: 409 message: App name already exists description: Creates a new application with the specified name, network allowlist, and optional description and products. Returns the created app with its generated API keys and configured chain network endpoints. summary: Create app security: - api_key: - ADMIN_APPS_READ_WRITE - user_auth: - developer - admin parameters: [] requestBody: required: true content: application/json: schema: properties: name: type: string description: type: string networkAllowlist: items: type: string type: array description: Alchemy chain network id to be enabled. Value is in the form of `{chain}_{network}` (e.g. `ETH_MAINNET`) products: items: enum: - node-api - nft-api - swaps-api - block-timestamp-api - token-api - transfers-api - bundler-api - debug-api - embedded-accounts - gas-manager-api - trace-api - prices-api - transaction-simulation-api - transaction-receipts-api - user-operations-api - smart-websockets - webhooks - grpc type: string type: array description: Product to be enabled for app required: - name - networkAllowlist type: object additionalProperties: false ```