POST /v1/storage/stores/integration/direct

Creates an integration store with automatic billing plan handling. For free resources, omit billingPlanId to auto-discover free plans. For paid resources, provide a billingPlanId from the billing plans endpoint.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Query parameters

Name Type Required Description
teamId String No

The Team identifier to perform the request on behalf of.

slug String No

The Team slug to perform the request on behalf of.

Request body fields

Name Type Required Description
source String No

Source of the store creation request

Valid values:

  • "backoffice"
  • "marketplace"
  • "external"
  • "oauth"
  • "v0"
  • "deploy-button"
  • "resource-claims"
  • "cli"

Default value: "marketplace"

billingPlanId String No

ID of the billing plan for paid resources. Get available plans from GET /integrations/integration/{id}/products/{productId}/plans. If not provided, automatically discovers free billing plans.

integrationConfigurationId String Yes

ID of your integration configuration. Get this from GET /v1/integrations/configurations

name String Yes

Human-readable name for the storage resource

paymentMethodId String No

Payment method ID for paid resources. Optional - uses default payment method if not provided.

externalId String No

Optional external identifier for tracking purposes

integrationProductIdOrSlug String Yes

ID or slug of the integration product. Get available products from GET /v1/integrations/configuration/{id}/products

metadata Object No

Optional key-value pairs for resource metadata

protocolSettings Object No

Protocol-specific configuration settings

prepaymentAmountCents Number No

Amount in cents for prepayment billing plans. Required only for prepayment plans with variable amounts.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.