# Add coupon codes to coupon set

> For the complete machine-readable documentation index, see [llms.txt](https://apidocs.chargebee.com/llms.txt).


[Idempotency Supported](/docs/api/idempotency)

This API add coupon codes to an existing coupon set.

## Sample Request

#### cURL

```bash
curl  https://{site}.chargebee.com/api/v2/coupon_sets/cs_3RtyuLol/add_coupon_codes \
     -u {site_api_key}:\
     -d "code[0]"="CBCC789"
```

#### .NET

```dotnet
using ChargeBee.Api;
using ChargeBee.Models;

ApiConfig.Configure("{site}","{site_api_key}");
EntityResult result = CouponSet.AddCouponCodes("cs_3RtyuLol")
		.Code(new List<string>{"CBCC789"})
		.Request();

CouponSet couponSet = result.CouponSet;
```

#### Go

```go
package main
import (
    "fmt"
    "github.com/chargebee/chargebee-go/v3"
    couponsetAction "github.com/chargebee/chargebee-go/v3/actions/couponset"
    "github.com/chargebee/chargebee-go/v3/models/couponset"
)
func main() {
    chargebee.Configure("{site_api_key}","{site}");
    res,err := couponsetAction.AddCouponCodes("cs_3RtyuLol", &couponset.AddCouponCodesRequestParams{
        Code : []string{"CBCC789"},
    }).Request()
    if err != nil {
        fmt.Println(err)
    } else {
        CouponSet := res.CouponSet
    }
}
```

#### Go

```go
package main

import (
  "fmt"
  "github.com/chargebee/chargebee-go/v4"
)

func main() {
  config := &chargebee.ClientConfig{
    SiteName: "{site}",
    ApiKey: "{site_api_key}",
  }    
  client := chargebee.NewClient(config)
  req := &chargebee.CouponSetAddCouponCodesRequest{
    Code : []string{"CBCC789"},
}
  res, err := client.CouponSet.AddCouponCodes("cs_3RtyuLol", req)
      if err != nil {
        fmt.Println(err)
    } else {
        CouponSet := res.CouponSet
    }
}
```

#### Java

```java
import com.chargebee.*;
import com.chargebee.ListResult;
import com.chargebee.models.*;
import com.chargebee.models.enums.*;
import java.io.IOException;

public class Sample {

    public static void main(String args[]) throws IOException, Exception {
        Environment.configure("{site}", "{site_api_key}");
        Result result = CouponSet.addCouponCodes("cs_3RtyuLol")
            .code("CBCC789")
            .request();

        CouponSet couponSet = result.couponSet();
    }
}
```

#### Java

```java
import com.chargebee.v4.client.ChargebeeClient;
import com.chargebee.v4.models.couponSet.CouponSet;
import com.chargebee.v4.models.couponSet.params.CouponSetAddCouponCodesParams;
import com.chargebee.v4.models.couponSet.responses.CouponSetAddCouponCodesResponse;
import java.util.List;

public class CouponSetAddCouponCodes {

    public static void main(String[] args) {
        ChargebeeClient client = ChargebeeClient.builder()
            .apiKey("{site_api_key}")
            .siteName("{site}")
            .build();

        CouponSetAddCouponCodesParams params = CouponSetAddCouponCodesParams.builder()
            .code(List.of("CBCC789"))
            .build();

        CouponSetAddCouponCodesResponse response = client
            .couponSets()
            .addCouponCodes("cs_3RtyuLol", params);

        CouponSet couponSet = response.getCouponSet();
    }
}
```

#### Node.js

```node
import Chargebee from "chargebee";

const chargebee = new Chargebee({
    site: "{site}",
    apiKey: "{site_api_key}",
});

try {
    const result = await chargebee.couponSet.addCouponCodes("cs_3RtyuLol", {
        code: ["CBCC789"]
    });

    console.log(result);
    const couponSet = result.coupon_set;
} catch (err) {
    console.log(err);
}
```

#### PHP

```php
<?php

require __DIR__ . '/vendor/autoload.php';

use Chargebee\ChargebeeClient;

$chargebee = new ChargebeeClient(options: [
    "site" => "{site}",
    "apiKey" => "{site_api_key}",
]);
$result = $chargebee->couponSet()->addCouponCodes("cs_3RtyuLol", [
    "code" => ["CBCC789"]
]);
$couponSet = $result->coupon_set;
```

#### Python

```python
from chargebee import Chargebee

cb_client = Chargebee(api_key="{site_api_key}", site="{site}")
response = cb_client.CouponSet.add_coupon_codes("cs_3RtyuLol",
    cb_client.CouponSet.AddCouponCodesParams(
        code=["CBCC789"]
    )
)
coupon_set = response.coupon_set
```

#### Ruby

```ruby
require 'chargebee'

ChargeBee.configure(:site => "{site}",
  :api_key => "{site_api_key}")

result = ChargeBee::CouponSet.add_coupon_codes("cs_3RtyuLol",{
  :code => ["CBCC789"]
})

coupon_set = result.coupon_set
```

## Sample Response

```json
{
  "coupon_set": {
    "archived_count": 0,
    "coupon_id": "sample_coupon",
    "id": "cs_3RtyuLol",
    "name": "Weekend Offer",
    "object": "coupon_set",
    "redeemed_count": 0,
    "total_count": 1
  }
}
```

## URL Format

**POST** https://[site].chargebee.com/api/v2/coupon_sets/{coupon-set-id}/add_coupon_codes

## Input Parameters

- `code` (optional, string, max chars=50)
  You can pass up to 100 values per API call. You can also use the Chargebee UI to pass up to 1000 codes per operation. There is no limit on the total number of coupon codes that can be included in a coupon set.

## Returns

- `coupon_set` (Coupon set object)
  Resource object representing coupon\_set
