Skip to main content
POST
/
apps
/
{client_id}
/
providers
/
{provider_id}
/
activation
/
upload
curl -X POST \
  -H "Authorization: Bearer sk_workspace_test_..." \
  -F "files=@/path/to/customer_agreement.pdf" \
  -F "files=@/path/to/privacy_policy.pdf" \
  "https://sandbox.api.hopae.com/connect/v1/apps/abc123/providers/ftn/activation/upload"

{
  "documents": [
    {
      "contractId": "6789abcd",
      "fileName": "customer_agreement.pdf",
      "fileSize": 245760,
      "contentType": "application/pdf",
      "uploadedAt": "2026-03-20T10:30:00.000Z",
      "state": "pending"
    },
    {
      "contractId": "6789abce",
      "fileName": "privacy_policy.pdf",
      "fileSize": 128000,
      "contentType": "application/pdf",
      "uploadedAt": "2026-03-20T10:30:01.000Z",
      "state": "pending"
    }
  ]
}
Uploads one or more documents required by the provider’s activation flow. Use the documents list from the upload step in Get Activation Steps to determine which documents to upload. Maximum 10 files per request. Maximum file size is 10 MB each.

​
Request

​
Authorization
string
required
Bearer <API_KEY> from Console > Developers > Workspace API Keys.
​
Content-Type
string
multipart/form-data

​
Path parameters

​
client_id
string
required
Client identifier of the app.
​
provider_id
string
required
Provider identifier (e.g., ftn, spid-ig, idin, ipin, pass).

​
Request body

​
files
file[]
required
One or more document files to upload. Use the same field name files for each file.

​
Response

Returns an object containing an array of uploaded document objects.
​
documents
object[]
List of uploaded document objects.
After uploading, the activation flow advances to the review step. If a document is rejected during review, the step moves back to upload — check the uploaded array in Get Activation Steps for documents with "state": "rejected" and re-upload the corrected files to this endpoint. 
curl -X POST \
  -H "Authorization: Bearer sk_workspace_test_..." \
  -F "files=@/path/to/customer_agreement.pdf" \
  -F "files=@/path/to/privacy_policy.pdf" \
  "https://sandbox.api.hopae.com/connect/v1/apps/abc123/providers/ftn/activation/upload"

{
  "documents": [
    {
      "contractId": "6789abcd",
      "fileName": "customer_agreement.pdf",
      "fileSize": 245760,
      "contentType": "application/pdf",
      "uploadedAt": "2026-03-20T10:30:00.000Z",
      "state": "pending"
    },
    {
      "contractId": "6789abce",
      "fileName": "privacy_policy.pdf",
      "fileSize": 128000,
      "contentType": "application/pdf",
      "uploadedAt": "2026-03-20T10:30:01.000Z",
      "state": "pending"
    }
  ]
}