Allows Twilio Marketplace publishers to manually report customer usage on No-code Partner Listings that they own

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://twilio.demo.bump-doc.com/doc/marketplace/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
"marketplace MCP server": {
  "url": "https://twilio.demo.bump-doc.com/doc/marketplace/mcp"
}
Close
POST /v1/InstalledAddOns/{InstalledAddOnSid}/Usage
Account sid auth token

Allows Twilio Marketplace publishers to manually report customer usage on No-code Partner Listings that they own.

Path parameters

  • InstalledAddOnSid string Required

    Customer Installation SID to report usage on.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^XE[0-9a-fA-F]{32}$.

application/json

Body Required

  • billable_items array[object] Required
    Hide billable_items attributes Show billable_items attributes object
    • quantity number Required

      Total amount in local currency that was billed for this Billing Item. Can be any floating number greater than 0.

    • sid string Required

      BillingSid to use for billing.

Responses

  • 202 application/json

    Accepted

    Hide response attributes Show response attributes object
    • total_submitted number

      Total amount in local currency that was billed in this request. Aggregates all billable_items that were successfully submitted.

    • billable_items array[object] Required
      Hide billable_items attributes Show billable_items attributes object
      • quantity number Required

        Total amount in local currency that was billed for this Billing Item. Can be any floating number greater than 0.

      • sid string Required

        BillingSid to use for billing.

      • submitted boolean

        Whether the billing event was successfully generated for this Billable Item.
POST /v1/InstalledAddOns/{InstalledAddOnSid}/Usage 
curl \
 --request POST 'https://marketplace.twilio.com/v1/InstalledAddOns/BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Usage' \
 --user "username:password" \
 --header "Content-Type: application/json" \
 --data '{"billable_items":[{"sid":"BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","quantity":12.355},{"sid":"BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","quantity":44.02}]}'
Request example 
{
  "billable_items": [
    {
      "sid": "BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "quantity": 12.355
    },
    {
      "sid": "BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "quantity": 44.02
    }
  ]
}
Response examples (202) 
{
  "total_submitted": 44.02,
  "billable_items": [
    {
      "sid": "BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "quantity": 12.355,
      "submitted": false
    },
    {
      "sid": "BIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "quantity": 44.02,
      "submitted": true
    }
  ]
}