POST v2/EviSMS/Batches/{batchid}/Recipients

HTTP Method: POST

Description:

This endpoint is used to add recipients for a specific bulk SMS batch. The batchid parameter in the URL is the identifier returned by the Submit endpoint. Recipients are added to the existing list, and there is a limit of 500 recipients per request. For more recipients, multiple calls can be made.

Headers

The following headers can be included in the CSV string as column names:

• PhoneNumber(*): SMS mobile phone number of the recipient.

• LegalName(*): Legal name of the recipient.

• LookupKey(*): Unique identifier for the recipient (e.g., a customer ID).

• EvidenceAccessControlChallenge(*): Challenge question for secure evidence access (optional).

• EvidenceAccessControlChallengeResponse(*): Response to the challenge question (optional).

• Additional Headers: User-defined variables that can be used to compose personalized notifications.

(* ) Cabecera obligatoria

Input Parameters

1. Recipients (string)

   • A CSV-like string containing the recipients' details.

   • The first line specifies the headers (e.g., column names).

   • Each subsequent line contains a recipient’s data, separated by commas, with one recipient per line.

   • Example Format without additional headers:

     lookupKey|phoneNumber|legalName|evidenceAccessControlChallenge|evidenceAccessControlChallengeResponse 001|+34600000000|RecipientName1|| 002|+34600000001|RecipientName2|| 003|+34600000002|RecipientName3||

     Example Format with additional headers:

     lookupKey|phoneNumber|legalName|evidenceAccessControlChallenge|evidenceAccessControlChallengeResponse|varamount|varcontract 001|+34600000000|RecipientName1||12|Contract1 002|+34600000001|RecipientName2||40|Contract2 002|+34600000001|RecipientName2||30|Contract3 002|+34600000001|RecipientName2||41|Contract4

Output Parameters

• No output parameters.

  • The endpoint returns an HTTP status code to indicate the result of the operation.

Request Example