Create a store

post

https://api-sandbox.buyingfreedom.app/api/manufacturers/stores

If the ffl_license_number exists in the BFG database and the FFL isn’t yet linked to a store, a new store is automatically created and linked to that FFL.
However, if the FFL is already linked, the submission will be connected to the existing store..
If no FFL exists, the system checks for an exact match of name, address_1, address_2, address_3, city, state, postal_code, and. All values must match.
If no exact match is found, the system uses AI to look for possible typos or close matches.
If no existing store is found, the system creates a new store and links it to the brand determined by the token in the request.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

ffl_license_number

string | null

The FFL license number for the store.

name

string

required

The name of the store. Must be unique within the postal code. Maximum length: 255 characters.

friendly_name

string | null

A friendly display name for the store. Maximum length: 255 characters.

logo

file

The company logo. Must be a valid image file. Maximum file size: 2 MB.

phone

string | null

The store's phone number. Maximum length: 25 characters.

string | null

The store's email address. Must be a valid email address. Maximum length: 255 characters.

website

string | null

The store's website URL. Must be a valid URL. Maximum length: 255 characters.

store_pickup

boolean

Indicates whether the store offers store pickup.

online_shopping

boolean

Indicates whether the store offers online shopping.

low_stock_threshold

integer

The low stock threshold for inventory alerts.

address_1

string | null

The store's primary street address. Maximum length: 255 characters.

address_2

string | null

An optional second address line. Maximum length: 255 characters.

address_3

string | null

An optional third address line. Maximum length: 255 characters.

city

string | null

The city where the store is located. Maximum length: 60 characters.

state

string | null

The state where the store is located. For US addresses, must be a valid two-letter state code. Maximum length: 30 characters.

postal_code

string | null

The ZIP code of the store. Maximum length: 255 characters.

country

string | null

The country where the store is located. Maximum length: 255 characters.

is_residential

boolean

Indicates whether the store is at a residential address.

uses_ffl

boolean

Whether the store uses FFL services.

manufacturer_account_number

string | null

The manufacturer account number. Maximum length: 255 characters.

product_url

string | null

The product URL. Must be a valid URL. Maximum length: 255 characters.

brand_url

string | null

The brand URL. Must be a valid URL. Maximum length: 255 characters.

brand_signed_terms

boolean

Whether brand terms have been signed.

brand_terms_file

file | null

Brand terms file upload. Must be a PDF file.

store_tags

array of strings

Array of store tags.

store_tags

store_types

array of strings

Array of store types.

store_types

show_on_locator

boolean | null

Whether the store appears in the store locator.

show_stock_availability

boolean | null

Whether to show stock availability for this store.

show_website

boolean | null

Whether to show the store's website.

is_promoted

boolean | null

Whether the store is promoted.

Responses

200

401Unauthenticated

403Unauthorized access

422Unprocessable entity