Bulk upload offers from CSV

POST

provider

offers

bulk-upload

curl --request POST \
  --url https://api.offergrid.io/provider/offers/bulk-upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form file='@example-file'

{
  "totalRows": 123,
  "successCount": 123,
  "errorCount": 123,
  "createdOfferIds": [
    "<string>"
  ],
  "errors": [
    {}
  ],
  "warnings": [
    {}
  ]
}

Authorizations

x-api-key

string

header

required

Team API key for authentication. Your team role (provider/reseller/hybrid) determines which endpoints you can access.

Body

multipart/form-data

file

CSV file with offer data (use the template from GET /bulk-upload/template)

Response

Bulk upload completed

totalRows

number

required

Total rows processed

successCount

number

required

Number of successfully created offers

errorCount

number

required

Number of failed offers

createdOfferIds

string[]

required

Created offer IDs

errors

object[]

required

Detailed errors for failed rows

warnings

object[]

Warnings for all rows

Validate CSV file without creating offersUpload a CSV file to validate its structure and data without actually creating offers. This is useful for checking your CSV before performing the actual bulk upload.

Bulk upload offers from CSV

curl --request POST \
  --url https://api.offergrid.io/provider/offers/bulk-upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form file='@example-file'

{
  "totalRows": 123,
  "successCount": 123,
  "errorCount": 123,
  "createdOfferIds": [
    "<string>"
  ],
  "errors": [
    {}
  ],
  "warnings": [
    {}
  ]
}