Discount codes

​

List discount codes

neetocal discount-codes list --kind fixed --code SAVE --page 1 --page-size 50

• Each row carries redeems_count, the number of times the code has been used on a booking that counts as redeemed.
• --code matches codes containing the text you pass; --kind matches exactly. Passing both narrows to codes that satisfy each.

​

Create a discount code

neetocal discount-codes create \
  --code SAVE10 --kind percentage --value 10 \
  --meeting-ids abc123x --expires-at 2026-12-31

• Use --kind percentage with a --value from 1 to 100, or --kind fixed with a flat amount up to 100000. A fixed amount is charged in your workspace’s default currency, which the response reports as currency; a percentage code returns currency: null, because a percentage is not an amount of money.
• --expires-at takes a date such as 2026-12-31. The API stores it as an ISO 8601 timestamp.
• --meeting-ids are meeting SIDs from meetings list, not UUIDs. In --quiet mode, the command prints the new code’s identifier.
• --json-file takes an object whose keys are the fields the API accepts: code, kind, value, expires_at, meeting_ids, allowed_emails, redeems_limit, redeems_limit_by_email and days_valid_after_first_use_per_client. The last four have no flag of their own, so a file is the only way to set them. Any flag you also pass wins over the file.

{
  "data": {
    "discount_code": {
      "id": "d6ccef53-f369-4b54-a818-6e93e2a0455c",
      "code": "SAVE10",
      "value": 10,
      "kind": "percentage",
      "currency": null,
      "redeems_limit": null,
      "redeems_limit_by_email": null,
      "expires_at": "2026-12-31T00:00:00.000Z",
      "days_valid_after_first_use_per_client": null,
      "meetings": [
        { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "Product demo" }
      ]
    }
  }
}

​

Update a discount code

neetocal discount-codes update d6ccef53-f369-4b54-a818-6e93e2a0455c \
  --value 20 --expires-at 2027-06-30

• <id> - Discount code UUID

• The id is the discount code UUID from discount-codes list, not the code itself.
• Only the flags you pass are sent, so omitting --value leaves the existing discount untouched rather than resetting it.

​

Delete a discount code

neetocal discount-codes delete d6ccef53-f369-4b54-a818-6e93e2a0455c

• <id> - Discount code UUID

• The code is disabled straight away and removed shortly afterwards, so it stops applying to new bookings as soon as the command returns.
• discount-codes list returns only enabled codes, so a deleted code is gone from the list on the very next call. A script can delete and then list to confirm without waiting.
• Bookings that already redeemed the code keep their discount.