​

Reserved Namespaces

​

Integration Namespaces

​

Tool Slugs

​

Usage Guidelines

​

When to Use Namespaces

1. Database Field Names: Always prefix custom fields with the appropriate integration namespace
2. API Parameters: Use namespaced keys when passing integration-specific data
3. Configuration Keys: Apply namespaces to settings and configuration values
4. Event Names: Prefix events with their source integration namespace

​

Best Practices

• Consistency: Always use the exact namespace prefix as defined in the table
• Lowercase: Keep all namespace prefixes in lowercase
• Underscore Separation: Use underscores to separate the namespace from the field name
• Descriptive Names: Combine namespace with clear, descriptive field names

​

Examples

// Database field names
const customer = {
  id: "cust_001",
  shopify_customer_id: "123456789",
  stripe_customer_id: "cus_ABC123DEF456",
  paypal_payer_email: "customer@example.com",
};

// Configuration keys
const integrationSettings = {
  shopify_webhook_secret: "whsec_...",
  stripe_publishable_key: "pk_...",
  paypal_client_id: "client_...",
};

// Event names
const events = ["shopify_order_created", "stripe_payment_succeeded", "paypal_payment_completed"];

​

Adding New Namespaces

1. Research: Check if the integration already has a commonly used namespace convention
2. Consistency: Choose a namespace that follows the existing pattern (lowercase, descriptive)
3. Documentation: Update this table with the new namespace
4. Team Review: Have the team review the proposed namespace before implementation

​

Reserved Prefixes

• cona_ - Core CONA system fields and identifiers
• temp_ - Temporary fields that may be cleaned up
• system_ - System-generated fields and metadata
• audit_ - Audit trail and versioning fields