> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.brevo.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.brevo.com/_mcp/server. # Create coupons for a coupon collection POST https://api.brevo.com/v3/coupons Content-Type: application/json Add coupons to an existing coupon collection. The `coupons` array must contain between 1 and 10,000 unique coupon code strings, all associated with the specified `collectionId`. Coupon creation is processed asynchronously and a `204` status is returned immediately upon acceptance. Returns a `404` error if the specified coupon collection does not exist. Reference: https://developers.brevo.com/reference/create-coupons ## Authentication - `api-key` header (required) — The API key should be passed in the request headers as `api-key` for authentication. ## Request ### Body (application/json) This endpoint expects an object. - `collectionId` (string, required) — The id of the coupon collection for which the coupons will be created - `coupons` (list of string, required) ## Response ### 204 Coupons creation in progress ## Errors ### 400 Bad Request Error bad request - `code` (enum, required) — Error code displayed in case of a failure - Allowed values: `invalid_parameter`, `missing_parameter`, `out_of_range`, `campaign_processing`, `campaign_sent`, `document_not_found`, `not_enough_credits`, `permission_denied`, `duplicate_parameter`, `duplicate_request`, `method_not_allowed`, `unauthorized`, `account_under_validation`, `not_acceptable`, `bad_request`, `unprocessable_entity`, `Domain does not exist`, `Contact email not found`, `Attribute not found`, `Category id not found`, `Invalid parameters passed`, `Record(s) for identifier not found`, `Returned when query params are invalid`, `Returned when invalid data posted`, `Feed not found`, `Campaign ID not found`, `api-key not found`, `DMARC policy requires domain authentication`, `DNS records not properly configured`, `Invalid OTP code provided`, `OTP code has expired`, `Domain already exists in your account`, `The sum of all IP weights must equal 100`, `Authentication failed`, `Insufficient credits`, `Request already processed` - `message` (string, required) — Readable message associated to the failure ### 401 Unauthorized Error bad request - `code` (enum, required) — Error code displayed in case of a failure - Allowed values: `invalid_parameter`, `missing_parameter`, `out_of_range`, `campaign_processing`, `campaign_sent`, `document_not_found`, `not_enough_credits`, `permission_denied`, `duplicate_parameter`, `duplicate_request`, `method_not_allowed`, `unauthorized`, `account_under_validation`, `not_acceptable`, `bad_request`, `unprocessable_entity`, `Domain does not exist`, `Contact email not found`, `Attribute not found`, `Category id not found`, `Invalid parameters passed`, `Record(s) for identifier not found`, `Returned when query params are invalid`, `Returned when invalid data posted`, `Feed not found`, `Campaign ID not found`, `api-key not found`, `DMARC policy requires domain authentication`, `DNS records not properly configured`, `Invalid OTP code provided`, `OTP code has expired`, `Domain already exists in your account`, `The sum of all IP weights must equal 100`, `Authentication failed`, `Insufficient credits`, `Request already processed` - `message` (string, required) — Readable message associated to the failure ### 404 Not Found Error Coupon collection not found - `message` (string, required) — Readable message associated to the failure - `code` (string, optional) — Error code displayed in case of a failure ## Examples **Request** ```json { "collectionId": "23befbae-1505-47a8-bd27-e30ef739f32c", "coupons": [ "Uf12AF" ] } ``` **SDK Code** ```typescript import { BrevoClient } from "@getbrevo/brevo"; async function main() { const client = new BrevoClient({ apiKey: "YOUR_API_KEY_HERE", }); await client.coupons.createCoupons({ collectionId: "23befbae-1505-47a8-bd27-e30ef739f32c", coupons: [ "Uf12AF", ], }); } main(); ``` ```python from brevo import Brevo client = Brevo( api_key="YOUR_API_KEY_HERE", ) client.coupons.create_coupons( collection_id="23befbae-1505-47a8-bd27-e30ef739f32c", coupons=[ "Uf12AF" ], ) ``` ```php coupons->createCoupons( new CreateCouponsRequest([ 'collectionId' => '23befbae-1505-47a8-bd27-e30ef739f32c', 'coupons' => [ 'Uf12AF', ], ]), ); ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.brevo.com/v3/coupons" payload := strings.NewReader("{\n \"collectionId\": \"23befbae-1505-47a8-bd27-e30ef739f32c\",\n \"coupons\": [\n \"Uf12AF\"\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("api-key", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.brevo.com/v3/coupons") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["api-key"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"collectionId\": \"23befbae-1505-47a8-bd27-e30ef739f32c\",\n \"coupons\": [\n \"Uf12AF\"\n ]\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.brevo.com/v3/coupons") .header("api-key", "") .header("Content-Type", "application/json") .body("{\n \"collectionId\": \"23befbae-1505-47a8-bd27-e30ef739f32c\",\n \"coupons\": [\n \"Uf12AF\"\n ]\n}") .asString(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.brevo.com/v3/coupons"); var request = new RestRequest(Method.POST); request.AddHeader("api-key", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"collectionId\": \"23befbae-1505-47a8-bd27-e30ef739f32c\",\n \"coupons\": [\n \"Uf12AF\"\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "api-key": "", "Content-Type": "application/json" ] let parameters = [ "collectionId": "23befbae-1505-47a8-bd27-e30ef739f32c", "coupons": ["Uf12AF"] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.brevo.com/v3/coupons")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```