Skip to main content
The Azure Blob Storage connector lets FlexOrch pull files directly from a blob container in your Azure Storage account. Once connected, you can reference the connector in processing requests or pair it with Scheduled Sync to automatically process new blobs as they arrive.

​
Prerequisites

Before you create the connector, make sure you have the following ready:
  • An active Azure subscription with a Storage account
  • A blob container holding the documents you want to ingest
  • A Storage account access key (found under Security + networking → Access keys in the Azure portal)

​
Create the connector

Send a POST /v1/connectors request with type: "azure_blob" and your account details in the config object. 
curl -X POST https://api.flexorch.com/v1/connectors \
  -H "X-API-KEY: dfx_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "azure_blob",
    "name": "my-azure-connector",
    "config": {
      "account_name": "mystorageaccount",
      "container_name": "documents",
      "account_key": "..."
    }
  }'
After creating the connector, test it to confirm FlexOrch can reach your container:
cURL
curl -X POST https://api.flexorch.com/v1/connectors/44/test \
  -H "X-API-KEY: dfx_your_key_here"
Storage account keys provide full access to your storage account. FlexOrch encrypts your connector configuration at rest, but you should treat access keys as sensitive secrets, rotate them regularly, and consider restricting network access to your storage account using Azure firewall rules.
SAS token support is coming soon. When available, you will be able to use a Shared Access Signature with scoped permissions and an expiry date instead of a full account key.

​
Ingest files from Azure Blob

With the connector in place, pass its id as source.connector_id and supply an array of blob names (paths within the container) you want to process.
cURL
curl -X POST https://api.flexorch.com/v1/data-process/async \
  -H "X-API-KEY: dfx_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "connector_id": 44,
      "keys": [
        "legal/contracts/master_agreement.pdf",
        "legal/contracts/amendment_01.pdf"
      ]
    }
  }'

​
Config field reference

​
account_name
string
required
The name of your Azure Storage account (e.g., mystorageaccount).
​
container_name
string
required
The name of the blob container FlexOrch will read from.
​
account_key
string
required
A Storage account access key. You can find this in the Azure portal under your storage account’s Access keys blade.
​
prefix
string
An optional blob prefix (virtual folder path) used as the default scope for Scheduled Sync — for example, incoming/2024/. Only blobs under this prefix will be polled.