Create a venue

The driving distance and drive time from your own business address are worked out in the background, exactly as they are for a venue added in the app, and appear on later reads. Images can’t be attached over the API: an upload needs a signed URL this API doesn’t hand out.

Only name is required. Give an address if you want the distance: without one there is nothing to route to, and distanceMeters and durationSeconds stay null.

Errors

422 venue_name_required — no name, or a blank one.

POST/api/v1/venues

Authorization

AuthorizationBearer token (bloomcount_...) · headerrequired

Request body

requiredapplication/json

namestring

What the venue is called. Required to create.

addressstring

Full postal address. Setting or changing it schedules the distance lookup; distanceMeters and durationSeconds read null until that finishes.

googleMapsUrlstring

A maps link for whoever is driving. Not used for routing.

phonestring

The venue's main number.

websitestring

The venue's website.

contactNamestring

Who to speak to at the venue.

contactEmailstring

Email for that contact.

contactPhonestring

Direct number for that contact.

notesstring

Free text — access

entryStartstring

Earliest access time

entryEndstring

Latest access time

Responses

201Created

venueIdstringrequired

namestringrequired

What the venue is called. This is what an event shows.

addressstring | null

Full postal address. What the driving distance is measured to, so a venue without one has no distance.

googleMapsUrlstring | null

A maps link for whoever is driving. Not used for routing.

phonestring | null

The venue's main number.

websitestring | null

The venue's website.

contactNamestring | null

Who to speak to at the venue.

contactEmailstring | null

Email for that contact.

contactPhonestring | null

Direct number for that contact

notesstring | null

Free text — access

entryStartstring | null

Earliest time the venue allows access, as free text.

entryEndstring | null

Latest time the venue allows access, as free text.

distanceMetersinteger | null

Driving distance from your business address. Null until the background lookup has run, or when either address is missing.

durationSecondsinteger | null

Driving time from your business address, on the same terms as distanceMeters.

401Missing or invalid API key, or revoked / expired.

errorstringrequired

403Authenticated, but the key lacks the required scope or the tenant has no API access.

errorstringrequired

422Request body or arguments failed validation.

errorstringrequired

429Per-minute rate limit (60/min) or per-month cap exceeded.

errorstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (bloomcount_...)Remember on this deviceInclude my values in samples

Bodyapplication/json

namestringWhat the venue is called. Required to create.addressstringFull postal address. Setting or changing it schedules the distance lookup; distanceMeters and durationSeconds read null until that finishes.googleMapsUrlstringA maps link for whoever is driving. Not used for routing.phonestringThe venue's main number.websitestringThe venue's website.contactNamestringWho to speak to at the venue.contactEmailstringEmail for that contact.contactPhonestringDirect number for that contact.notesstringFree text — accessentryStartstringEarliest access timeentryEndstringLatest access time

Request

curl -X POST "https://app.bloomcount.com/api/v1/venues" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "address": "string",
  "googleMapsUrl": "string",
  "phone": "string",
  "website": "string",
  "contactName": "string",
  "contactEmail": "string",
  "contactPhone": "string",
  "notes": "string",
  "entryStart": "string",
  "entryEnd": "string"
}'

const response = await fetch("https://app.bloomcount.com/api/v1/venues", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"string\",\n  \"address\": \"string\",\n  \"googleMapsUrl\": \"string\",\n  \"phone\": \"string\",\n  \"website\": \"string\",\n  \"contactName\": \"string\",\n  \"contactEmail\": \"string\",\n  \"contactPhone\": \"string\",\n  \"notes\": \"string\",\n  \"entryStart\": \"string\",\n  \"entryEnd\": \"string\"\n}"
});

import requests

response = requests.post(
    "https://app.bloomcount.com/api/v1/venues",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"string\",\n  \"address\": \"string\",\n  \"googleMapsUrl\": \"string\",\n  \"phone\": \"string\",\n  \"website\": \"string\",\n  \"contactName\": \"string\",\n  \"contactEmail\": \"string\",\n  \"contactPhone\": \"string\",\n  \"notes\": \"string\",\n  \"entryStart\": \"string\",\n  \"entryEnd\": \"string\"\n}",
)

Response

{
  "venueId": "ven_k2m7p4r9t3v6x1z8b5n0q7w4",
  "name": "The Manor Barn",
  "address": "The Manor Barn, Bath BA1 5TQ",
  "googleMapsUrl": null,
  "phone": "+44 1225 000000",
  "website": null,
  "contactName": "Rosa Levine",
  "contactEmail": "events@manorbarn.example",
  "contactPhone": null,
  "notes": "Deliveries to the courtyard entrance.",
  "entryStart": null,
  "entryEnd": null,
  "distanceMeters": 18400,
  "durationSeconds": 1620
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}