---
title: "Create giveaway links"
method: POST
path: "/open-api/v1.0/giveaway-links"
tags: ["Giveaway links"]
---

# Create giveaway links

`POST /open-api/v1.0/giveaway-links`

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Creates a new package with specified number of giveaway links

## Request body

- ComFourthwallAppOpenapiEndpointCreateGiveawayLinksV1Request
  - `productId` string, uuid, required
  - `number` integer, required

## Response `200`

OK

- ComFourthwallOpenapiModelGiveawayLinksV1
  - `packageId` string, required
  - `giveawayLinks` union[], required
    - union
      - ComFourthwallOpenapiModelGiveawayLinksV1GiveawayLinkV1Available
        - `status` 'AVAILABLE', required
        - `id` string, required
        - `link` string, required
        - `productId` string, required
        - `createdAt` string, date-time, required
      - ComFourthwallOpenapiModelGiveawayLinksV1GiveawayLinkV1Cancelled
        - `status` 'CANCELLED', required
        - `id` string, required
        - `link` string, required
        - `productId` string, required
        - `createdAt` string, date-time, required
        - `cancelledAt` string, date-time, required
      - ComFourthwallOpenapiModelGiveawayLinksV1GiveawayLinkV1Redeemed
        - `status` 'REDEEMED', required
        - `id` string, required
        - `link` string, required
        - `productId` string, required
        - `createdAt` string, date-time, required
        - `redeemedAt` string, date-time, required

## Other responses

- `400` — Possible errors: `GIFT_INVALID_OFFER`
- `404` — Possible errors: `OFFER_NOT_FOUND_ERROR`, `SHOP_TEAM_MEMBER_SHOP_NOT_FOUND_ERROR`
- `429` — Rate limited: 100 requests / 10 seconds per shop.

---

[API](https://skmtc.net/fourthwall/apis/fourthwall-apis-2.md) · [All operations](https://skmtc.net/fourthwall/apis/fourthwall-apis-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthwall/fourthwall-apis-2/versions/ef273312f051/schema)