> ## Documentation Index > Fetch the complete documentation index at: https://giftbit.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Create direct link order > Places an order for direct link rewards — URLs that go straight to rewards with minimal Giftbit branding and no template content or message. The reward URLs are generated and returned immediately in the response. A direct link reward can be a full catalog of options in a specific `region`, or a custom reward of one or more specific `brand_codes` (which must be from the same region). Set `link_count` to generate more than one direct link at a time. ## OpenAPI ````yaml /api-reference/openapi.yaml post /direct_links openapi: 3.1.0 info: title: Giftbit API version: v1 description: > Giftbit's REST API lets you automatically order rewards and send them to your recipients. Delivery can be handled either by links that integrate into another system's workflow, or by emails sent through the Giftbit system. Authenticate every request with a bearer token in the `Authorization` header. Only an HTTP `200` means success; all non-`200` responses share a common error body. contact: name: Giftbit Support email: testbed@giftbit.com url: https://www.giftbit.com/api-documentation servers: - url: https://api-testbed.giftbit.com/papi/v1 description: Testbed - url: https://api.giftbit.com/papi/v1 description: Production security: - bearerAuth: [] tags: - name: Ping description: Test your authentication and check the health of the Giftbit API. - name: Brands description: List reward brands and retrieve extended information about a single brand. - name: Regions description: List the regions used to filter brands and request Full Catalog rewards. - name: Email Orders description: Order one or more rewards delivered to recipients by Giftbit email. - name: Shortlink Orders description: Order branded shortlink rewards that include a customized landing page. - name: Direct Link Orders description: >- Order minimally branded direct link rewards returned immediately in the response. - name: Embedded Rewards description: >- Order a single in-app reward for immediate delivery in your app or website. - name: Funds description: Retrieve your account balance and top it up with a credit card payment. - name: Rewards description: List, retrieve, resend, and cancel individual rewards. paths: /direct_links: post: tags: - Direct Link Orders summary: Create direct link order description: > Places an order for direct link rewards — URLs that go straight to rewards with minimal Giftbit branding and no template content or message. The reward URLs are generated and returned immediately in the response. A direct link reward can be a full catalog of options in a specific `region`, or a custom reward of one or more specific `brand_codes` (which must be from the same region). Set `link_count` to generate more than one direct link at a time. operationId: create-direct-link-order requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DirectLinkCreateRequest' example: id: clientProvidedId_abc123 price_in_cents: 2500 expiry: '2025-01-01' region: USA link_count: 1 responses: '200': description: Order creation has begun; direct link URLs are returned. content: application/json: schema: type: object properties: info: $ref: '#/components/schemas/Info' status: type: integer direct_links: type: array items: type: string campaign: $ref: '#/components/schemas/Campaign' example: info: code: INFO_CAMPAIGN_CREATED name: Campaign Created message: Campaign creation has begun. status: 200 direct_links: - >- https://reward.giftbit.com/getReward/dl-59ec25692ca940358fcd51e91e3d1fdb campaign: company_name: Company Name message: Here is your reward! subject: null contacts: null status: API_CREATING uuid: aa10bbe7bfa64b4a81d61d3ade419653 suppress_default_greeting: false delivery_type: DIRECT_LINK region: USA expiry: '2025-01-01' id: clientProvidedId_abc123 components: schemas: DirectLinkCreateRequest: type: object required: - id - price_in_cents anyOf: - required: - brand_codes - required: - region properties: id: type: string description: >- A unique client-assigned identifier for the order. Idempotent on retry. price_in_cents: type: integer expiry: type: string brand_codes: type: array items: type: string description: >- One or more brand_codes from the same region. Omit for a Full Catalog reward. region: type: string description: Region for a Full Catalog reward. link_count: type: integer description: Number of reward links to generate (positive integer). Info: type: object description: Status information returned on successful requests. properties: code: type: string description: An enum-style status code for the request. name: type: string description: Human-readable status name. message: type: string description: Request-context-specific message. Campaign: type: object description: An order object. properties: company_name: type: string message: type: string subject: type: - string - 'null' contacts: type: - array - 'null' items: type: object price_in_cents: type: integer brand_codes: type: array items: type: string region: type: string description: 'Full Catalog region name. Possibilities: USA, Canada.' status: type: string enum: - API_CREATING - AWAITING_FUNDS - CAMPAIGN_CREATED uuid: type: string suppress_default_greeting: type: boolean delivery_type: type: string enum: - GIFTBIT_EMAIL - SHORTLINK - DIRECT_LINK expiry: type: string contacts_success_count: type: integer contacts_failure_count: type: integer link_count: type: integer fees: $ref: '#/components/schemas/Fees' gift_template: type: string id: type: string Fees: type: object description: Information about the cost of the order and any associated fees. properties: cost_entries: type: array items: type: object properties: percentage: type: number fee_type: type: string amount_in_cents: type: integer currency: type: string tax_type: type: string tax_in_cents: type: - integer - 'null' number_of_gifts: type: integer fee_per_gift_in_cents: type: integer subtotal_in_cents: type: integer tax_in_cents: type: integer tax_type: type: string total_in_cents: type: integer securitySchemes: bearerAuth: type: http scheme: bearer description: Send your API token prefixed by `Bearer ` in the `Authorization` header. ````