> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/api-reference/files/integrations/save-files-integration.md).

# Save Files Integration

save Files Integration.

An **integration** connects an external provider to this module. Configure the provider and its secrets in Cloud; the API lets you list, create or update, enable, disable, set a default, and test integrations.

This endpoint creates the files integration and returns its id.

{% openapi src="/files/0gOkqzp7kyziG9XPpCBy" path="/{version}/files/integrations" method="post" %}
[norbix-hub-swagger.json](https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-7c7445e68689b62620e59cb01a3523deb46b865b%2Fnorbix-hub-swagger.json?alt=media)
{% endopenapi %}

## Providers this endpoint accepts

The body carries one shape per provider (`provider` plus that provider's own fields). Not every value of the `FileProvider` enum is accepted:

| Provider                                                                    | Accepted                                                                                                                                                                                              |
| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AwsS3`, `AzureBlobStorage`, `GoogleCloudStorage`, `GoogleDrive`, `DropBox` | Yes                                                                                                                                                                                                   |
| `Local`                                                                     | Only on a self-hosted server whose operator set a files root — see [Local](/codemash/cloud/files/integrations/providers/local.md)                                                                     |
| `Ftp`, `AppleICloud`                                                        | **No.** Since September 2026 the endpoint answers `CM-ERRORS-FILES-023`, "The FTP provider is not available in this version." The enum values stay so that integrations saved earlier still read back |

`GET /{version}/files/integrations` answers `availableProviders`: the list this deployment will accept right now. Read it rather than hard-coding the enum.

## In Cloud

Manage this visually in Cloud — see [Files](/codemash/cloud/files/integrations.md).

## Use it from code

Every Norbix SDK exposes this endpoint as a method — see [Save Files Integration](/codemash/sdks/files/integrations/save-files-integration.md) in the SDK reference, with examples in every language.