---
title: "Import Resource"
method: PUT
path: "/v1/installations/{integrationConfigurationId}/resources/{resourceId}"
tags: ["marketplace"]
---

# Import Resource

`PUT /v1/installations/{integrationConfigurationId}/resources/{resourceId}`

This endpoint imports (upserts) a resource to Vercel's installation. This may be needed if resources can be independently created on the partner's side and need to be synchronized to Vercel. When importing as part of the user-initiated import flow, call this endpoint before redirecting the user back to Vercel. See the [Import existing resources flow](https://vercel.com/docs/integrations/create-integration/marketplace-flows#import-existing-resources-flow) for the full contract.

## Path parameters

- `integrationConfigurationId` string, required
- `resourceId` string, required

## Request body

- object
  - `ownership` 'owned' | 'linked' | 'sandbox'
  - `productId` string, required
  - `name` string, required
  - `status` 'ready' | 'pending' | 'onboarding' | 'suspended' | 'resumed' | 'uninstalled' | 'error', required
  - `metadata` object
  - `billingPlan` object
    - `id` string, required
    - `type` 'prepayment' | 'subscription', required
    - `name` string, required
    - `description` string
    - `paymentMethodRequired` boolean
    - `cost` string
    - `details` object[]
      - `label` string, required
      - `value` string
    - `highlightedDetails` object[]
      - `label` string, required
      - `value` string
    - `effectiveDate` string
  - `notification` object
    - `level` 'info' | 'warn' | 'error', required
    - `title` string, required
    - `message` string
    - `href` string, uri
  - `extras` object
  - `secrets` object[]
    - `name` string, required
    - `value` string, required
    - `prefix` string
    - `environmentOverrides` object — A map of environments to override values for the secret, used for setting different values across deployments in production, preview, and development environments. Note: the same value will be used for all deployments in the given environment.
      - `development` string — Value used for development environment.
      - `preview` string — Value used for preview environment.
      - `production` string — Value used for production environment.

## Response `200`

- object
  - `name` string, required

## Other responses

- `400` — One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `409`
- `410`
- `422`
- `429`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)