Managing Resources

Integration resources are provider-specific items that you manage after connecting a provider. Not every provider has resources — they are specific to providers that expose configurable items like email addresses, phone numbers, or webhook endpoints. Resources live at the instance level (Tier 4 of the integration model) and are shared across all users connected to that instance.

What Are Resources

Resources are the operational building blocks of an integration. They bridge the gap between "we are connected to Postmark" and "we can actually send emails from hello@otesse.com." Without resources, a connected provider has credentials but no operational configuration.

Resource TypeProviderWhat It Represents
Sender EmailPostmarkA verified email address used as the "From" address when sending transactional emails
Phone NumberQuo (OpenPhone)A provisioned phone number used as the "From" number when sending SMS messages
Webhook URLStripeAn endpoint URL where Stripe sends payment event notifications
Model PreferenceAnthropicThe selected AI model for content generation features

Accessing Resource Management

Resources are managed through the Connected Apps drawer:

  1. Navigate to Settings > Integrations > Connected Apps
  2. Click on a connected provider to open its management drawer
  3. The drawer displays provider-specific resource management options

Each provider's drawer is tailored to its resource types. Postmark shows a table of sender emails, Quo shows phone numbers, and providers without resources (like Mapbox) show a simpler connection status view.

Postmark: Sender Emails

Postmark resources are sender email addresses — the addresses that appear in the "From" field when Otesse sends transactional emails (booking confirmations, invoice notifications, password resets).

Adding a Sender Email

  1. Open the Postmark provider drawer from Connected Apps
  2. Click "Add Sender Email"
  3. Enter the email address (e.g., support@otesse.com)
  4. Optionally provide a display label (e.g., "Support Team")
  5. Click "Save"

The email is created as an IntegrationResource with resourceType: "sender_email".

Setting a Default

One sender email must be marked as the default. The default email is used by the Email Builder as the pre-selected "From" address when creating new email campaigns or templates.

To set a default:

  • Click the star icon next to any sender email
  • The previous default is automatically un-starred
  • The Email Builder immediately picks up the change

Editing and Deleting

  • Edit: Click the pencil icon to modify the label or email address
  • Delete: Click the trash icon to remove the sender email. A confirmation dialog appears: "Remove this sender email? It will no longer be available in the Email Builder."

Verification Status

Each sender email has a verification status:

StatusMeaning
VerifiedThe email is confirmed and ready to send
PendingVerification is in progress
UnverifiedThe email has not been verified with Postmark

Only verified emails can be used for sending. Unverified emails appear in the resource list but are not available in the Email Builder's "From" dropdown.

Quo (OpenPhone): Phone Numbers

Quo resources are phone numbers used for SMS messaging. They appear in the SMS Builder's "From" dropdown.

Adding a Phone Number

  1. Open the Quo provider drawer from Connected Apps
  2. Click "Add Phone Number"
  3. Enter the phone number in E.164 format (e.g., +15550100)
  4. Optionally provide a display label (e.g., "Main Business Line")
  5. Click "Save"

Managing Phone Numbers

The management interface mirrors the Postmark experience:

  • Default number: One number is marked as default and pre-selected in the SMS Builder
  • Edit: Modify the label or number
  • Delete: Remove the number with confirmation

Stripe: Webhook Endpoints

Stripe resources are webhook endpoint URLs where Stripe delivers payment event notifications (successful payments, failed charges, subscription changes).

Viewing Webhook Status

The Stripe drawer shows:

  • Connection status (connected/error)
  • Active webhook endpoints with their delivery health
  • Recent webhook events received

Active/Inactive Toggle

Administrators can toggle the Stripe integration active or inactive. When inactive, Stripe webhook events are not processed (they receive a 410 Gone response).

Other Providers

Providers without resource types (Mapbox, Google Maps, Geoapify) display a simplified drawer:

SectionContent
Connection StatusGreen dot for connected, red for error
Active ToggleEnable or disable the integration
API Key StatusMasked display of the stored key (last 4 characters)
Last Health CheckTimestamp and result of the most recent health check

Workflow Integration

Resources are not standalone — they are referenced by other features in the platform:

FeatureResource UsedHow
Email BuilderPostmark sender emails"From" address dropdown populated from Postmark resources where isDefault = true or selected manually
SMS BuilderQuo phone numbers"From" number dropdown populated from Quo resources
Payment ProcessingStripe webhook URLsStripe events delivered to configured webhook endpoints
AI FeaturesAnthropic model preferenceContent generation uses the selected model

When you add or remove a resource, the dependent features update immediately. If you delete a sender email that is currently selected in an email template, the template falls back to the default sender email.

Resource Limits

ProviderMax ResourcesNotes
Postmark50 sender emailsPostmark account limits may apply independently
Quo25 phone numbersBased on provisioned numbers in your Quo account
Stripe10 webhook endpointsStripe webhook limits may apply independently
Anthropic1 model preferenceSingle active model selection