> ## 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 Default Storefront Link

> Create a link for the default storefront of a brand



## OpenAPI

````yaml https://app.levanta.io/api/creator/v1/openapi.json post /links/storefronts
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:
    post:
      tags:
        - Links
      summary: Create Default Storefront Link
      description: Create a link for the default storefront of a brand
      operationId: CreateDefaultStorefrontLink
      requestBody:
        description: The storefront link to create
        content:
          application/json:
            schema:
              type: object
              properties:
                brand_id:
                  type: string
                  format: uuid
                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
              required:
                - brand_id
      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 default 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 default
                        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: Default Storefront for Brand or Link Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: number
                    enum:
                      - 404
                  message:
                    type: string
                    enum:
                      - Default Storefront for Brand 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

````