Create an offer

Creates a new offer and returns the created object.

Body·OfferCreateRequest

required

application/json

Offer payload when creating an offer.
type
Discriminator
enum
const:
banner
required

The offer type.

info_link
Type: string
max length:
1000
required

URL the recipient is redirected to when clicking the offer.

media
Type: OfferMedia
required
Properties: 2
offer_id
Type: string
max length:
30
required

Identifier for the offer. Case-insensitive, must be unique and non-blank. Allowed characters: alphanumeric.

text
Type: string
max length:
1000
required

Body text shown in both banner and sale offers.

title
Type: string
max length:
200
required

Short title shown in both banner and sale offers.

link_text
Type: string

Link label shown together with the offer, if provided.

Note: This field may be returned if provided, but is currently not used by the product/UI.

Responses

application/json
application/json
application/json
application/json
application/json

post/offer

curl https://sandbox.billogram.com/api/v2/offer \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Basic username:password' \
  --data '{
  "offer_id": "banner001",
  "type": "banner",
  "title": "Summer sale!",
  "text": "30% on everything at Mike'\''s Bike until September.",
  "info_link": "http://example.com/",
  "media": {
    "picture": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
    "picture_type": "image/png"
  }
}'

Show Schema

{
  "status": "OK",
  "data": {
    "offer_id": "banner001",
    "type": "banner",
    "title": "string",
    "text": "string",
    "media": {
      "picture": "string",
      "picture_type": "image/png"
    },
    "link_text": "string",
    "created_at": "2026-10-13T14:05:09.731Z",
    "updated_at": "2026-10-13T14:05:09.731Z",
    "info_link": "string"
  }
}

Offer response