OAuth connection — field reference

When the connection is saved successfully, Hubhus shows status Connected. You do not need to add an Authorization header on any HTTP request — Hubhus injects the Bearer token automatically when the OAuth connection is selected.

Step 1 — Create basket: full request

Method: POST    URL: https://api.gogift.io/baskets

Headers:

Accept: application/json
Content-Type: application/json

Body:

{
  "salesChannelId": "109"
}

JSON property map:

id  →  {{basketid}}

The response contains the GoGift basket ID. Mapping id to {{basketid}} makes it available in the following requests.

Step 2 — Update basket: full request

Method: PUT    URL: https://api.gogift.io/baskets

Body:

{
  "id": "{{basketid}}",
  "paymentCurrency": "DKK",
  "doClearProducts": false,
  "reference": "%lead_id%",
  "buyer": {
    "accountId": "328685355341950976",
    "accountType": "B2BDepartment",
    "name": "YourCompany A/S",
    "email": "contact@yourcompany.dk",
    "phone": "+4500000000",
    "address": {
      "line1": "Street 1",
      "city": "City",
      "countryCode": "DK",
      "postCode": "0000"
    }
  },
  "addProducts": [
    {
      "deliveryMethod": "Email",
      "recipientName": "%lead_name%",
      "recipientEmail": "%lead_email%",
      "stockKeepingUnit": "FF79DB80",
      "productId": "256472009205907456",
      "quantity": 1,
      "giftcardValue": 50,
      "valueCurrency": "DKK"
    }
  ]
}

id vs. reference: id is the GoGift basket ID from Step 1. reference is your internal order/lead reference — always set this to %lead_id%. Production GoGift accounts typically require a reference, even if sandbox worked without it.

giftcardValue rules: minimum 50, step 10, maximum 5000. Valid: 50, 60, 100, 250. Invalid: 1, 55, 99.

Step 3 — Finalize basket: full request

Method: POST    URL: https://api.gogift.io/baskets/finalize

Body:

{
  "basketId": "{{basketid}}",
  "paymentMethod": "InvoiceByFinance",
  "countryCode": "DK"
}

This creates the confirmed order with GoGift and triggers delivery of the gift card to the recipient email.

Sandbox vs. production

Sandbox and production credentials are separate and not interchangeable. Product data also differs between environments:

Troubleshooting

OAuth credentials verification failed: Token exchange failed: HTTP 400

The OAuth token exchange is failing. Check:

• Are you using the correct Token URL for your environment (production vs. sandbox)?
• Are Scopes, Audience, and Custom token params all empty?
• Is the Client ID and Client Secret correct?

{"error":"invalid_client"}

GoGift is rejecting the Client ID or Client Secret. Verify your credentials directly with GoGift. This is not a basket configuration error.

The basket require order reference, but the order reference is not supplied

Add "reference": "%lead_id%" to the Step 2 Update basket body. Production accounts require this field even if sandbox worked without it.

GoGift returns HTML instead of JSON

Add the header Accept: application/json to the HTTP request.

Update basket or finalize fails with a product or value error

• Confirm productId and stockKeepingUnit match the correct environment
• Confirm giftcardValue is at least 50 and a multiple of 10
• Confirm recipientEmail is set when deliveryMethod is Email
• Confirm the GoGift OAuth connection is selected on the request

Pre-launch checklist

• OAuth connection is created and shows Connected
• OAuth connection is selected under Connection / Authentication on all three HTTP requests
• No manual Authorization header is set on any request
• Accept: application/json header is set on all requests
• Step 1 maps id to {{basketid}} in the JSON property map
• Step 2 sets id to {{basketid}}
• Step 2 sets reference to %lead_id%
• Step 2 uses the production productId and stockKeepingUnit
• giftcardValue is at least 50 and a multiple of 10
• Step 3 sets basketId to {{basketid}}