Get or create the default storefront link for a brand you have access to. The default storefront for a brand is the “home” page for the brand, if it exists.

Method: POST

Body (JSON):

• “brand_id”
  • id for the brand you wish to create the default storefront link for
  • can be retrieved using the brands API
• “source_id”
  • An ID that identifies where the created link will be used
    • Examples: “instagram”, “tiktok”, “blog”, etc.
  • If omitted, “default” will be used as the source ID
  • Allowed characters: [a-zA-Z0-9-_@./ ]
• “source_sub_id”:
  • An ID to further identify the link underneath the source_id namespace
    • Examples: “user1”, ‘https://www.source_id/@user”, “blogpost_23”
  • If omitted, “” will be used as sub_source_id, can not be filtered on
  • Allowed characters: [a-zA-Z0-9-_@./ ]
• “source_name”
  • Display name for the source within Levanta
  • Optional
• “associates_tag”
  • Value to override associates tag with
  • If omitted default account associates tag is used
    • if no default account associates tag is used, set to “maas”

Response:

{
  "id": "string",
  "sourceId": "string",
  "sourceSubId": "string",
  "sourceName": "string",
  "url": "string",
  "active": true,
  "type": "product",
  "marketplace": "amazon.com",
  "levantaProductCount": 0 // how many active Levanta products on this storefront
}

Errors:

• 400: Bad Request
  • Parameters incorrectly formatted or missing permissions to create a link for the requested brand_id
• 401: Unauthorized
  • Invalid or omitted API Key

Example:

const API_KEY = "LEVANTA_API_KEY";
const ENDPOINT = `https://app.levanta.io/api/creator/v1/links/storefronts`;

const res = await fetch(ENDPOINT, {
	method: "POST",
	headers: {
		Authorization: `Bearer ${API_KEY}`,
        "Content-Type": "application/json"
	},
	body: JSON.stringify({
				brand_id: "abc_123",
        source_id: "instagram",
				source_sub_id: "post_22",
				source_name: "Instagram Affiliate Post #22"
    })
});

const link = await res.json();
console.log(link);