Connect Backblaze B2

Backblaze B2 offers some of the lowest storage costs available. This guide walks you through connecting your B2 bucket to HeftySend.

Custom storage requires a Premium or Ultra plan. See Using your own storage with HeftySend for an overview.

Step 1: Create your B2 bucket

Go to your Backblaze B2 Console
Click "Create a Bucket"
Enter a unique bucket name
Set "Files in Bucket are" to Private
Click "Create a Bucket"

Step 2: Set up CORS rules

Click on your bucket name to open its settings
Find "Bucket Settings" and click on it
Under "CORS Rules", click "Update CORS Rules"
Paste this configuration:

[
  {
    "corsRuleName": "heftysend",
    "allowedOrigins": ["*"],
    "allowedOperations": [
      "s3_head",
      "s3_get",
      "s3_put",
      "s3_post",
      "s3_delete"
    ],
    "allowedHeaders": ["*"],
    "exposeHeaders": ["ETag"],
    "maxAgeSeconds": 3000
  }
]

Click "Update"

Backblaze uses a different CORS format from most providers. Make sure you use the exact format above with the s3_ operation names.

Step 3: Create an application key

Go to App Keys in your account
Click "Add a New Application Key"
Enter a name (for example, HeftySend)
Select your bucket from the dropdown
Set "Type of Access" to Read and Write
Click "Create New Key"

Save the keyID and applicationKey immediately — the applicationKey is only shown once.

Step 4: Find your S3 endpoint

Your S3-compatible endpoint follows this format:

https://s3.[REGION].backblazeb2.com

The region is shown in your bucket's endpoint details. For example: s3.us-west-004.backblazeb2.com

Step 5: Connect to HeftySend

Go to Settings > Storage in your HeftySend dashboard
Click "Configure S3 Storage"
Enter your S3-compatible endpoint URL
Enter your keyID as "Access Key ID"
Enter your applicationKey as "Secret Access Key"
Enter your bucket name
Select your region from the dropdown
Click "Test Connection" then "Save"

Common Backblaze regions

Region code	Location
us-west-000	US West (Sacramento)
us-west-002	US West (Phoenix)
us-west-004	US West
eu-central-003	EU Central (Amsterdam)

The region is always visible in your bucket endpoint URL.

Troubleshooting

Use the S3-compatible endpoint (s3.[region].backblazeb2.com), not the native B2 endpoint. Make sure you are using the keyID as the Access Key ID, not the account ID.