Create a spend limit

POST

spend_limits

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const SpendLimit = await client.spendLimits.create();

console.log(SpendLimit.data);

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)
spend_limit = client.spend_limits.create()
print(spend_limit.data)

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go"
	"github.com/team-telnyx/telnyx-go/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"),
	)
	spendLimit, err := client.SpendLimits.New(
		context.TODO(),
		telnyx.SpendLimitNewParams{
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", spendLimit.Data)
}

package com.telnyx.sdk.example;

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.spendLimits.SpendLimitCreateParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        TelnyxClient client = TelnyxOkHttpClient.fromEnv();

        SpendLimitCreateParams params = SpendLimitCreateParams.builder()
            .build();
        var response = client.spendLimits().create(params);
    }
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');

try {
  $spend_limit = $client->spendLimits->create();

  var_dump($spend_limit);
} catch (APIException $e) {
  echo $e->getMessage();
}

curl --request POST \
  --url https://api.telnyx.com/v2/spend_limits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "product": "inference",
  "period": "daily",
  "amount": 100,
  "reason": "Team budget"
}
'

{
  "data": {
    "record_type": "spend_limit",
    "product": "inference",
    "product_name": "Inference",
    "period": "daily",
    "period_start": "2026-09-24",
    "period_end": "2026-09-25",
    "limit": {
      "amount": "100",
      "unlimited": false,
      "origin": "self_service",
      "updated_at": "2026-09-24T09:12:03.412Z"
    },
    "effective_limit_usd": "100",
    "spend_usd": "37.41",
    "spend_error": null,
    "blocked": false,
    "block": null,
    "evaluation": {
      "spend_usd": "37.41",
      "released": false,
      "blocked_now": false,
      "still_over_limit": false,
      "still_blocked_other_period": false,
      "evaluation_deferred": false
    }
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Amount
Unlimited

Send exactly one of amount and unlimited: true.

product

string

required

Product to limit, as returned in product by the list operation.

Example:

"inference"

amount

number

required

Limit in USD. 0 blocks at the first cent of spend.

Required range: x >= 0

Example:

100

period

enum<string>

default:daily

daily is the current UTC day; monthly is the current UTC calendar month.

Available options:

daily,

monthly

Example:

"daily"

unlimited

enum<boolean>

Optional; only false is allowed together with amount.

Available options:

false

Example:

false

reason

string

Why the limit is set or changed, kept for audit.

Maximum string length: 500

Example:

"Team budget"

Response

The limit was created. evaluation says whether the change blocked the product.

data

object

required

The spend limit, spend and block state of one product and period.

Show child attributes

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const SpendLimit = await client.spendLimits.create();

console.log(SpendLimit.data);

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)
spend_limit = client.spend_limits.create()
print(spend_limit.data)

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go"
	"github.com/team-telnyx/telnyx-go/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"),
	)
	spendLimit, err := client.SpendLimits.New(
		context.TODO(),
		telnyx.SpendLimitNewParams{
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", spendLimit.Data)
}

package com.telnyx.sdk.example;

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.spendLimits.SpendLimitCreateParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        TelnyxClient client = TelnyxOkHttpClient.fromEnv();

        SpendLimitCreateParams params = SpendLimitCreateParams.builder()
            .build();
        var response = client.spendLimits().create(params);
    }
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');

try {
  $spend_limit = $client->spendLimits->create();

  var_dump($spend_limit);
} catch (APIException $e) {
  echo $e->getMessage();
}

curl --request POST \
  --url https://api.telnyx.com/v2/spend_limits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "product": "inference",
  "period": "daily",
  "amount": 100,
  "reason": "Team budget"
}
'

{
  "data": {
    "record_type": "spend_limit",
    "product": "inference",
    "product_name": "Inference",
    "period": "daily",
    "period_start": "2026-09-24",
    "period_end": "2026-09-25",
    "limit": {
      "amount": "100",
      "unlimited": false,
      "origin": "self_service",
      "updated_at": "2026-09-24T09:12:03.412Z"
    },
    "effective_limit_usd": "100",
    "spend_usd": "37.41",
    "spend_error": null,
    "blocked": false,
    "block": null,
    "evaluation": {
      "spend_usd": "37.41",
      "released": false,
      "blocked_now": false,
      "still_over_limit": false,
      "still_blocked_other_period": false,
      "evaluation_deferred": false
    }
  }
}

Account & Billing

Video

SETI

Fax

OAuth

Bot Signup

For AI Agents

Create a spend limit

Authorizations

Body

Response