Superfiliate

Fulfill a gifting reward

Bearer authgifting_rewards.writeBetaAlpha
Alpha: This endpoint is currently in alpha and is not available to all API integrations.

Marks a merchant-managed gifting reward as shipped and saves its OMS and tracking details. The creator must have submitted their details first, so the reward is in ready_to_send.

Repeating the same request is idempotent. A later request with different fulfillment details is rejected. Shopify gifting rewards are not available through this endpoint.

POSTapi.superfiliate.com/api/v1/gifting_rewards/{id}/fulfill

Path parameters1

idrequired
integer
Gifting reward ID

Body parametersapplication/json

  • external_order_idstring

    Order ID in the merchant's OMS

  • carrierstring

    Shipping carrier

  • tracking_numberstring

    Carrier tracking number

  • tracking_urlstring

    HTTP(S) tracking URL

Responses

Gifting reward fulfilled

  • idinteger
  • gifting_stageenum<string>

    Current lifecycle stage for this reward.

    "unlocked""claimed""shipped""delivered""expired""paused""skipped""not_eligible""pending""error""ready_to_send""missing_address""order_placed""posted"

  • Program associated with this resource.

    • idinteger
    • namestring

      Human-readable name for this resource.

  • Creator associated with this resource.

    • idinteger
    • first_namestring

      Person's given name.

    • last_namestring

      Person's family name.

    • emailstring

      Email address for this person.

    • phonestring

      Phone number for this person.

  • Shipping address for this reward.

    • address1string

      First line of the shipping address.

    • address2string | null

      Second line of the shipping address, when provided.

    • citystring

      City in the shipping address.

    • country_codestring

      ISO country code in the shipping address.

    • province_codestring | null

      Province or state code in the shipping address.

    • zipstring

      Postal or ZIP code in the shipping address.

  • The selected products for this resource.

    • product_external_idstring

      Identifier for the related product external.

    • variant_external_idstring

      Identifier for the related variant external.

    • product_titlestring

      The product title for this resource.

    • variant_titlestring

      The variant title for this resource.

    • image_urlstring | null

      URL for image.

    • skustring | null

      The sku for this resource.

    • The options for this resource.

      • namestring

        Human-readable name for this resource.

      • valuestring

        The value for this resource.

    • quantityinteger

      The quantity for this resource.

    • selected_atstring

      ISO 8601 timestamp for selected.

  • The fulfillment for this resource.

    • external_order_idstring | null

      Identifier for the related external order.

    • carrierstring | null

      The carrier for this resource.

    • tracking_numberstring | null

      The tracking number for this resource.

    • tracking_urlstring | null

      URL for tracking.

    • fulfilled_atstring

      ISO 8601 timestamp for fulfilled.

  • details_submitted_atstring

    ISO 8601 timestamp for details submitted.

  • created_atstring

    ISO 8601 timestamp when this resource was created.

  • updated_atstring

    ISO 8601 timestamp when this resource was last updated.