View All Products
Compute
Storage
Databases
Networking
Developer Tools
Delivery
Security
Services
Industries
Pricing
Community
Engage With Us
Linode API 4.163.0

Endpoints

Account

Promo Credit Add

post
https://api.linode.com/v4/account/promo-codes

Adds an expiring Promo Credit to your account.

The following restrictions apply:

  • Your account must be less than 90 days old.
  • There must not be an existing Promo Credit already on your account.
  • The requesting User must be unrestricted. Use the User Update (PUT /account/users/{username}) to change a User's restricted status.
  • The promo_code must be valid and unexpired.

Request Body Schema

promo_code
Required
string [1 .. 32] characters

The Promo Code.

Request Samples

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -X POST -d '{
    "promo_code": "abcdefABCDEF1234567890"
  }' \
  https://api.linode.com/v4/account/promo-codes

Response Samples

{
  "credit_monthly_cap": "10.00",
  "credit_remaining": "50.00",
  "description": "Receive up to $10 off your services every month for 6 months! Unused credits will expire once this promotion period ends.",
  "expire_dt": "2018-01-31T23:59:59",
  "image_url": "https://linode.com/10_a_month_promotion.svg",
  "summary": "$10 off your Linode a month!",
  "this_month_credit_remaining": "10.00",
  "service_type": "all"
}

Responses

200: Promo Credit successfully added.

credit_monthly_cap
string

The amount available to spend per month.

credit_remaining
string

The total amount of credit left for this promotion.

description
string

A detailed description of this promotion.

expire_dt
string

When this promotion's credits expire.

image_url
string

The location of an image for this promotion.

summary
string

Short details of this promotion.

this_month_credit_remaining
string

The amount of credit left for this month for this promotion.

service_type
string
Enum: "all""backup""blockstorage""db_mysql""ip_v4""linode""linode_disk""linode_memory""longview""managed""nodebalancer""objectstorage""transfer_tx"

The service to which this promotion applies.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.