name: front-id-converter description: Convert between Front URL IDs (base-10) and API IDs (base-36 with prefix). Use when working with Front inbox, conversation, or message IDs. allowed-tools: Bash

Front ID Converter Skill

Convert between Front URL IDs (base-10) and API IDs (base-36 with prefix).

Conversion Rules

Front API IDs are created by:

1. Converting the numeric URL ID (base-10) to base-36
2. Adding a resource prefix

Resource Prefixes

URL to API ID

function urlToApiId(urlId: number, prefix: string): string {
  return `${prefix}${urlId.toString(36)}`
}

// Example: Inbox [PHONE] → inb_4bj7r
urlToApiId([PHONE], 'inb_') // => "inb_4bj7r"

API ID to URL

function apiIdToUrl(apiId: string): number {
  const base36 = apiId.split('_')[1]
  return parseInt(base36, 36)
}

// Example: inb_4bj7r → [PHONE]
apiIdToUrl('inb_4bj7r') // => [PHONE]

Quick Bash Conversion

# URL ID to API ID (requires node)
node -e "console.log('inb_' + ([PHONE]).toString(36))"

# API ID to URL ID
node -e "console.log(parseInt('4bj7r', 36))"

Common Use Cases

From Front URL

Given: https://app.frontapp.com/inboxes/teams/folders/[PHONE]/unassigned/[PHONE]

• Inbox ID: [PHONE] → inb_4bj7r
• Conversation ID: [PHONE] → cnv_1z2x3y4z (calculate as needed)

Validating API Responses

When Front API returns an ID like inb_4bj7r, you can verify it matches the expected inbox by converting back to the URL ID.