---
title: "Create external storage"
method: POST
path: "/external_storage"
tags: ["product:chat"]
---

# Create external storage

`POST /external_storage`

Creates new external storage

## Request body

- CreateExternalStorageRequest, nullable — Create external storage
  - `aws_s3` S3Request — Config for creating Amazon S3 storage.
    - `s3_api_key` string — The AWS API key. To use Amazon S3 as your storage provider, you have two authentication options: IAM role or API key. If you do not specify the `s3_api_key` parameter, Stream will use IAM role authentication. In that case make sure to have the correct IAM role configured for your application.
    - `s3_custom_endpoint_url` string — The custom endpoint for S3. If you want to use a custom endpoint, you must also provide the `s3_api_key` and `s3_secret` parameters.
    - `s3_region` string, required — The AWS region where the bucket is hosted
    - `s3_secret` string — The AWS API Secret
  - `azure_blob` AzureRequest — Config for creating Azure Blob Storage storage
    - `abs_account_name` string, required — The account name
    - `abs_client_id` string, required — The client id
    - `abs_client_secret` string, required — The client secret
    - `abs_tenant_id` string, required — The tenant id
  - `bucket` string, required — The name of the bucket on the service provider
  - `gcs_credentials` string
  - `name` string, required — The name of the provider, this must be unique
  - `path` string — The path prefix to use for storing files
  - `storage_type` 's3' | 'gcs' | 'abs', required — The type of storage to use

## Response `201`

Response

- CreateExternalStorageResponse, nullable — Basic response information
  - `duration` string, required — Duration of the request in milliseconds

## Other responses

- `400` — Bad request
- `429` — Too many requests

---

[API](https://skmtc.net/getstream/apis/stream-api.md) · [All operations](https://skmtc.net/getstream/apis/stream-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getstream/stream-api/versions/8d5c27f1f6b2/schema)