accessiBe Announces $12 Million Series A Funding

accessiBe Secures $12m Funding

Read News
Login Start Free Trial Free Trial Get Demo Demo
Need Some Help? No Problem! Browse through our frequently asked questions

Managing subscriptions from remote or in batches using our API or CSV file uploads

Looking to add a large number of websites at once? Wish to initiate a bulk purchase? Received API access to modify your licenses? This article explains it all.

There are two ways you can manage subscriptions in batches: API access, or CSV file uploads. Both methods work very similarly.

Please note:

  • In order to receive access to batch uploads or our API, contact sales first.
  • In both methods, you can upload up to 250 rows per request.

In this article, we’ll cover:

  1. Uploading a batch CSV file.
  2. Performing an API request.
  3. Required/optional fields for the CSV file or API request.

1. how to upload a CSV file from your account

Click here to download an example CSV file

  1. Login to our website, or click your name at the top menu if already logged-in, to trigger open your account management screen.
  2. Click the “My Websites” tab to reach the subscriptions/websites management panel.
  3. Click the “Click here for batch management” button
  4. Choose a CSV file from your computer and hit “upload”
  5. Error handling: if one or more of your entries failed, you'd see an explanation of the error fields right away. Usually, your entries did not pass our validations. For example, your email or telephone fields were not properly formatted. Simply fix the CSV and upload it again.

Make sure the first row has the below-required columns. Each row below the first is a single subscription, with fields corresponding to the columns. Jump to the next section to learn what fields the CSV needs to include and how they should be formatted.

2. how to perform an API request

Click here to download an example JSON payload

  1. API Endpoint:
  2. Add the API Key you received from us (contact us for one) as a HEADER of the request as follows: “Api-Key:{your-api-key}”.
  3. Make sure the “Content-Type” header is set to “application/json”.
  4. Make sure to POST the payload of your request in JSON format.
  5. Your JSON should include an ARRAY of objects. Each object contains the required/optional fields for managing a subscription.
  6. accessiBe will return an object with the results of the call, that includes the following fields:
    • Status – true/false – the result of your call
    • Message – a string explaining what went wrong if at all
    • Options – an array including additional information such as failed validations
  7. Common errors:
    • Missing or Incorrect API Key – either you did not include an “Api-Key” header with your API key, or your API key isn’t valid.
    • Invalid JSON Payload – either the “Content-Type header” is not set to “application/json” or your payload is not a valid JSON format.
    • Unknown error, contact us for help – well, should we explain? ?
    • Batch operation failed, please check your data – this means that all of your entries failed, probably due to an entry not passing validation. Check the “validations” object inside the options array of, it explains the issues.
    • X of your entries failed; the rest succeeded! – this means that some of your entries did not pass validations, but others did. Check the “validations” object inside the options array, it explains the issues.

3. Required/optional fields for the CSV or API request

  • domain – the domain name you’d like to add. Note: uploading a row with a domain that already exists with edit the fields. This way you can modify subscription info. Make sure your domain is formatted as follows: “ /” (no HTTP/S protocol nor www).

  • newDomain – to edit a domain license, add the new domain name in this field, and the domain to edit in the “domain” field above. Note that you need special permission from us (not all accounts are allowed) and a special “transferKey” from us. Make sure to follow the same format as above.

  • planId – requires a number from 1 to 3 according to your desired plan:
    1 = Pro Plan | 2 = Advanced Plan | 3 = Premium Plan.

  • contactName – the full name of the owner of the website (compliance requirement for the accessibility statement). Make sure to include a full name: e.g. “John Doe”.

  • contactPhone – the phone of the owner of the website without country code (compliance requirement for the accessibility statement). Make sure to include 9-10 digits only, without special characters, spaces or hyphens.

  • contactCountry – the country code of the website owner’s phone number. For example, “+1” for U.S and Canada (compliance requirement for the accessibility statement).

  • contactEmail – the email of the owner of the website (compliance requirement for the accessibility statement).

  • discountEnabled – can be empty | if you are entitled to a discount and you DON’T want it to be populated for that subscription (if you prefer it as a commission for example) put 0 in that field.

  • billingName – the name to put on the invoice (usually your business’s legal name).

  • billingEmail – can be empty | if you wish invoices to be sent to a specific email other than your account’s, add it here.

  • billingNotes – can be empty | any additional note or comment you add here will appear on the invoices.

  • transferKey – can be empty | a special password that allows editing domain licenses. This requires a special partnership deal with us, disregard it otherwise.

  • activationKey – can by empty |a special password that allows subscriptions to be activated automatically without payment. This is for payments being done offline (wire-transfer, etc.), disregard it otherwise.

  • paymentKey – can be empty | if you wish to pay for the subscriptions you are adding or modifying in this batch, add the payment key you received from us (contact us if you don’t have one), and accessiBe will enable an automatic charge from one of your already active subscriptions based on the cardFrom field below.

  • cardFrom – can be empty |to automatically generate a charge, you’ll have to make a single purchase manually. After that purchase, add the domain name of this newly active subscription here and accessiBe will use the credit-card submitted in it to charge and activate the current subscription from the CSV file.
Was this article helpful?
thumbs-up3 4
thumbs-down3 0