# Create a new business location

```http
POST https://api.synup.com/api/v4/locations
```

A **Location** represents a physical business entity within your account and serves as the foundation for managing and interacting with the API’s features. Each Location acts as a centralized hub for managing and accessing data related to that specific business, including:

- **Listings Management**: Maintain accurate and consistent business details across multiple publishers.
- **Review Monitoring**: Track and respond to customer feedback associated with the location.
- **Performance Insights**: Analyze key metrics related to visibility, engagement, and growth.
- **SEO Optimization**: Enhance local search presence and improve rankings.

**_See the Request Section for a detailed data schema of Supported Fields. Here’s a key detail to keep in mind:_**

:::info []

**Processing Time for Location Updates**
Updates to any location attributes, including `enabledSiteIds` or `submissionDisabledSiteIds`, are processed asynchronously before they are accurately reflected across all publishers and within the system.

 For example, If the business hours for a location are updated in the system, the changes are processed asynchronously before being reflected across all publishers.

:::

Source: https://developer.synup.com/api/locations/create-a-new-business-location

## Request body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `input` | object | optional |  |
| `input.tenure` | string | optional | Required when an account has multiple subscriptions. Specifies the tenure (e.g., Monthly). For accounts with multiple subscriptions, specify the tenure of the corresponding subscription. Refer to [Subscriptions](/api/locations/list-active-subscriptions) for details. |
| `input.storeId` | string | optional | Unique store identifier. Must be unique across all locations. |
| `input.subCategoryId` | integer | required | ID of the subcategory the business belongs to |
| `input.name` | string | required | Name of the business |
| `input.street` | string | required | Street address of the business |
| `input.street1` | string | optional | Additional street address information |
| `input.city` | string | required | City where the business is located |
| `input.postalCode` | string | required | Postal code of the business location |
| `input.phone` | string | required | - Must follow the international **E.164 format**. [Ref here.](https://www.twilio.com/docs/glossary/what-e164) - Do not include the `+` sign or country code. - Remove parentheses and special characters. - Example:   - **Incorrect**: `(123)-456-7890`, `+1-123-456-7890`   - **Correct**: `1234567890` |
| `input.stateIso` | string | required | State ISO code. Refer to the Places API for valid ISOs. |
| `input.countryIso` | string | required | Country ISO code. Refer to the Places API for valid ISOs. |
| `input.description` | string | required | Detailed description of the business |
| `input.ownerEmail` | string | optional | Email of the business owner |
| `input.ownerName` | string | optional | Name of the business owner |
| `input.bizUrl` | string | optional | URL of the business website |
| `input.facebookUrl` | string | optional | URL of the business's Facebook page |
| `input.twitterUrl` | string | optional | URL of the business's Twitter page |
| `input.linkedinUrl` | string | optional | URL of the business's LinkedIn page |
| `input.instagramUrl` | string | optional | URL of the business's Instagram page |
| `input.youtubeUrl` | string | optional | URL of the business's YouTube page |
| `input.tiktokUrl` | string | optional | URL of the business's TikTok page |
| `input.pinterestUrl` | string | optional | URL of the business's Pinterest page |
| `input.tagline` | string | optional | Tagline of the business |
| `input.paymentMethods` | array of string | optional | Accepted payment methods ("VISA", "MASTERCARD", "AMEX", "CASH", "CHEQUE", "CRYPTO", "DINERS_CLUB", "DISCOVER", "FINANCING", "INVOICE", "TRAVELERS_CHECK", "APPLE_PAY", "SAMSUNG_PAY", "PAYPAL", "ANDROID_PAY" ) |
| `input.yearOfIncorporation` | integer | optional | Year the business was established |
| `input.hideAddress` | boolean | optional | Set to true if location is a Service Area Business |
| `input.businessHours` | array of object | optional | Business hours for each day of the week |
| `input.businessHours[].day` | string | required | Day of the week One of: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY` |
| `input.businessHours[].slots` | array of object | required | Array of time slots (minimum 1, maximum 2). Required only if type is OPEN. |
| `input.businessHours[].slots[].start` | string | optional | Opening time. Valid formats: `<HH>:<MM>am` OR `<HH>:<MM>pm` |
| `input.businessHours[].slots[].end` | string | optional | Closing time. Valid formats: `<HH>:<MM>am` OR `<HH>:<MM>pm` |
| `input.businessHours[].type` | string | required | Type of business hours (e.g., OPEN, CLOSED, OPEN_24x7) One of: `OPEN`, `OPEN_24x7`, `CLOSED` |
| `input.additionalCategoryIds` | array of integer | optional | Additional category IDs for the business |
| `input.videos` | array of string | optional | List of valid video URLs |
| `input.enabledSiteIds` | array of integer | optional | List of site IDs where the business details should be published |
| `input.submissionDisabledSiteIds` | array of integer | optional | List of site IDs where the business details should not be published |
| `input.temporarilyClosed` | boolean | optional | Set to true if the location's business hours should be marked as closed |
| `input.additionalPhones` | array of string | optional | Additional contact phone numbers |
| `input.googleAdsPhone` | string | optional | Google Ads-specific phone number |
| `input.bookingUrl` | string | optional | URL for booking appointments. Applicable only for Food industry businesses |
| `input.offeringsUrl` | string | optional | URL for listing business offerings. Applicable only for food industry businesses |
| `input.reservationUrl` | string | optional | URL for making reservations. Applicable only for restaurant only businesses. |
| `input.placeActionLinks` | array of object | optional | Manage a location's Place Action Links |
| `input.placeActionLinks[].placeActionType` | string | required | One of the valid types. One of: `APPOINTMENT`, `ONLINE_APPOINTMENT`, `DINING_RESERVATION`, `FOOD_ORDERING`, `FOOD_DELIVERY`, `FOOD_TAKEOUT`, `SHOP_ONLINE` |
| `input.placeActionLinks[].isPreferred` | boolean | optional | Marks this link preferred for its type. At most one preferred per type. |
| `input.placeActionLinks[].uri` | string | required | Destination URL. |

## Example request

```bash
curl -X POST 'https://api.synup.com/api/v4/locations' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "tenure": "Monthly",
    "name": "Whisk & Bloom Bakery",
    "street": "123 Maple Avenue",
    "street1": "Suite 202",
    "city": "San Francisco",
    "postalCode": "94107",
    "phone": "(415) 555-1239",
    "stateIso": "CA",
    "countryIso": "US",
    "ownerEmail": "lana@whiskbloom.com",
    "ownerName": "Lana Thompson",
    "subCategoryId": 10,
    "description": "Whisk & Bloom Bakery offers a delightful selection of organic and gluten-free baked goods. Our mission is to provide fresh, handmade pastries and cakes crafted with love and the finest ingredients. Visit us for a cozy experience and enjoy our special seasonal treats!",
    "bizUrl": "https://www.whisknbloombakery.com/",
    "facebookUrl": "https://www.facebook.com/whisknbloomBakery/",
    "linkedinUrl": "https://www.linkedin.com/company/whisknbloombakery",
    "twitterUrl": "https://twitter.com/whisknbloomBakery",
    "instagramUrl": "https://www.instagram.com/whisknbloombakery/",
    "youtubeUrl": null,
    "tiktokUrl": null,
    "pinterestUrl": "https://www.pinterest.com/whisknbloombakery/",
    "tagline": "Fresh. Organic. Delicious.",
    "paymentMethods": [
      "VISA",
      "CASH"
    ],
    "yearOfIncorporation": 2015,
    "hideAddress": false,
    "businessHours": [
      {
        "day": "MONDAY",
        "slots": [
          {
            "start": "08:00am",
            "end": "12:00pm"
          },
          {
            "start": "01:00pm",
            "end": "06:00pm"
          }
        ],
        "type": "OPEN"
      },
      {
        "day": "TUESDAY",
        "slots": [
          {
            "start": "08:00am",
            "end": "06:00pm"
          }
        ],
        "type": "OPEN"
      },
      {
        "day": "WEDNESDAY",
        "slots": [
          {
            "start": "08:00am",
            "end": "06:00pm"
          }
        ],
        "type": "OPEN"
      },
      {
        "day": "THURSDAY",
        "slots": [
          {
            "start": "08:00am",
            "end": "06:00pm"
          }
        ],
        "type": "OPEN"
      },
      {
        "day": "FRIDAY",
        "slots": [
          {
            "start": "08:00am",
            "end": "06:00pm"
          }
        ],
        "type": "OPEN"
      },
      {
        "day": "SATURDAY",
        "slots": [
          {
            "start": "08:00am",
            "end": "04:00pm"
          }
        ],
        "type": "OPEN"
      },
      {
        "day": "SUNDAY",
        "slots": [],
        "type": "CLOSED"
      }
    ],
    "additionalCategoryIds": [],
    "videos": [],
    "enabledSiteIds": [],
    "submissionDisabledSiteIds": [],
    "temporarilyClosed": false,
    "additionalPhones": [
      "(415) 555-5678",
      "(415) 555-9012"
    ],
    "googleAdsPhone": "(415) 555-3456",
    "bookingUrl": "https://www.whisknbloombakery.com/reservations",
    "offeringsUrl": "https://www.whisknbloombakery.com/menu",
    "reservationUrl": "https://www.whisknbloombakery.com/book",
    "storeId": null,
    "placeActionLinks": [
      {
        "placeActionType": "FOOD_ORDERING",
        "uri": "https://order.example.com",
        "isPreferred": true
      },
      {
        "placeActionType": "FOOD_DELIVERY",
        "uri": "https://deliver.example.com"
      }
    ]
  }
}'
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Location created successfully |
| `400` | Bad request, invalid input |