> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.levanta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Storefront Link by ID

> Get a storefront link by its ID



## OpenAPI

````yaml https://app.levanta.io/api/creator/v1/openapi.json post /links/storefronts/{storefront_id}
openapi: 3.1.0
info:
  version: 1.0.0
  title: Levanta Creator API
  description: >-
    Authorize all requests with an API key in the Authorization header as the
    second token. E.g. Authorization -> "Bearer {api_key}".
servers:
  - url: https://app.levanta.io/api/creator/v1
security: []
externalDocs:
  url: https://app.levanta.io/creator/api-docs
paths:
  /links/storefronts/{storefront_id}:
    post:
      tags:
        - Links
      summary: Create Storefront Link by ID
      description: Get a storefront link by its ID
      operationId: CreateStorefrontLinkById
      parameters:
        - schema:
            type: string
            format: uuid
          required: true
          name: storefront_id
          in: path
      requestBody:
        description: The storefront link to create
        content:
          application/json:
            schema:
              type: object
              properties:
                source_id:
                  type: string
                  minLength: 1
                  maxLength: 256
                  pattern: ^[a-zA-Z0-9-_@./ ]*$
                  description: >-
                    An ID that identifies where the created link will be used.
                    Allowed characters: [a-zA-Z0-9-_@./ ]
                source_sub_id:
                  type: string
                  minLength: 1
                  maxLength: 256
                  pattern: ^[a-zA-Z0-9-_@./ ]*$
                  description: >-
                    An ID that identifies where the created link will be used.
                    Allowed characters: [a-zA-Z0-9-_@./ ]
                source_name:
                  type: string
                  maxLength: 250
                  default: ''
                  description: Display name for the source within Levanta
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  sourceId:
                    type: string
                    description: >-
                      An ID that identifies where the created link will be used.
                      Allowed characters: [a-zA-Z0-9-_@./ ]
                  sourceSubId:
                    type: string
                    description: >-
                      An ID to further identify the link underneath the
                      source_id namespace. Allowed characters: [a-zA-Z0-9-_@./ ]
                  sourceName:
                    type: string
                    description: Display name for the source within Levanta
                  url:
                    type: string
                  mobileOptimizedUrl:
                    type: string
                  active:
                    type: boolean
                    description: >-
                      Whether or not the link is active. Inactive links do not
                      earn commissions.
                  type:
                    type: string
                    enum:
                      - product
                      - storefront
                    description: >-
                      The type of the link. Product links are for amazon asin
                      pages. Storefront links are for amazon storefront pages.
                  marketplace:
                    type: string
                    enum:
                      - amazon.com
                      - amazon.co.uk
                      - amazon.com.mx
                      - amazon.ca
                      - amazon.de
                      - amazon.es
                      - amazon.fr
                      - amazon.it
                      - amazon.nl
                    description: The marketplace the link is associated with
                  levantaProductCount:
                    type: number
                required:
                  - id
                  - sourceId
                  - sourceSubId
                  - sourceName
                  - url
                  - mobileOptimizedUrl
                  - active
                  - type
                  - marketplace
                  - levantaProductCount
        '400':
          description: >-
            You do not have permission to create a storefront link for this
            brand
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: number
                    enum:
                      - 400
                  message:
                    type: string
                    enum:
                      - >-
                        You do not have permission to create a storefront link
                        for this brand
                required:
                  - status
                  - message
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: number
                    enum:
                      - 401
                  message:
                    type: string
                    enum:
                      - Unauthorized
                required:
                  - status
                  - message
        '404':
          description: Storefront or Link Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: number
                    enum:
                      - 404
                  message:
                    type: string
                    enum:
                      - Storefront or Link Not Found
                required:
                  - status
                  - message
        '415':
          description: 'Invalid Content Type: Must be "application/json" for post requests'
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: number
                    enum:
                      - 415
                  message:
                    type: string
                    enum:
                      - >-
                        Invalid Content Type: Must be "application/json" for
                        post requests
                required:
                  - status
                  - message
        '422':
          description: Input Validation Failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: number
                    enum:
                      - 422
                  message:
                    type: string
                    enum:
                      - Input Validation Failed
                required:
                  - status
                  - message
      security:
        - Bearer: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer

````