Create Customer Location | propelone

curl -X POST https://https//https/crm/customers/%7Bcustomer_id%7D/locations \
     -H "{{tenant_key_name}}: {{tenant_key_value1}}|{{tenant_key_value2}}" \
     -H "Content-Type: multipart/form-data" \
     -F city="Springfield" \
     -F state="IL" \
     -F country="US" \
     -F latitude="39.7817" \
     -F is_active="1" \
     -F longitude="-89.6501" \
     -F is_billing="0" \
     -F is_primary="1" \
     -F postal_code="62704" \
     -F contact_name="John Smith" \
     -F safety_notes="Beware of slippery steps during rain." \
     -F contact_email="john.smith@example.com" \
     -F contact_phone="+1-217-555-1234" \
     -F location_type="residential" \
     -F property_type="house" \
     -F address_line_1="456 Elm Street" \
     -F address_line_2="Unit 2" \
     -F location_notes="Backyard access preferred." \
     -F access_instructions="Use the keypad code 4321 at the front door." \
     -F is_service_location="1" \
     -F parking_instructions="Park on the street in front of the house." \
     -F preferred_visit_time="afternoon" \
     -F special_instructions="Please call 30 minutes before arrival."

{
  "data": {
    "id": "f6d39cb8-e8c2-4d78-aee9-54d479f5e933",
    "audit": {
      "created_at": "2025-09-15T20:19:33.000000Z",
      "created_by": 31,
      "updated_at": "2025-09-15T20:19:33.000000Z",
      "updated_by": 31
    },
    "flags": {},
    "access": {
      "instructions": "Use side gate, key under mat",
      "parking_instructions": "Park in driveway"
    },
    "address": {
      "city": "Anytown",
      "state": "CA",
      "line_1": "123 Main Street",
      "line_2": "Apt 4B",
      "country": "US",
      "postal_code": "90210"
    },
    "service": {},
    "customer": {
      "id": 1,
      "display_name": "Jane Doe",
      "customer_type": "residential"
    },
    "property": {
      "type": "house"
    },
    "seasonal": {},
    "conditions": {},
    "coordinates": {
      "latitude": 34.0901,
      "longitude": -118.4065
    },
    "customer_id": "d76970a0-3655-43a0-95cf-934949a8445e",
    "location_type": "residential",
    "created_by_user": {
      "id": 31,
      "name": "Propel Admin",
      "email": "admin@propelhub.com"
    },
    "updated_by_user": {
      "id": 31,
      "name": "Propel Admin",
      "email": "admin@propelhub.com"
    }
  },
  "meta": {
    "type": "customer_location",
    "version": "1.0",
    "generated_at": "2025-09-15T20:19:33.751028Z"
  }
}

Create a new location for a customer. Supports various location types including service, billing, mailing, and warehouse locations. Automatically geocodes addresses if coordinates are not provided. Can set primary and billing location flags.

Request

This endpoint expects a multipart form.

citystringRequired

Required: City name

statestringRequired

Required: State/Province code

countrystringRequired

Optional: Country code (defaults to US)

latitudestringRequired

Optional: Latitude coordinate for mapping

is_activestringRequired

Optional: Location is active (1=yes, 0=no) - defaults to 1

longitudestringRequired

Optional: Longitude coordinate for mapping

is_billingstringRequired

Optional: Set as billing location (1=yes, 0=no) - defaults to 0

is_primarystringRequired

Optional: Set as primary location (1=yes, 0=no) - defaults to 0

postal_codestringRequired

Required: ZIP/Postal code

contact_namestringRequired

Optional: Primary contact name at this location

safety_notesstringRequired

Optional: Safety considerations for service visits

contact_emailstringRequired

Optional: Primary contact email address

contact_phonestringRequired

Optional: Primary contact phone number

location_typestringRequired

Required: Location type (residential, commercial, industrial, agricultural, mixed)

property_typestringRequired

Required: Type of property house,apartment,office,warehouse,factory,retail,other

address_line_1stringRequired

Required: Street address

address_line_2stringRequired

Optional: Address line 2 (suite, apartment, etc.)

location_notesstringRequired

Optional: Additional notes about the location

access_instructionsstringRequired

Optional: Special access instructions for technicians

is_service_locationstringRequired

Optional: Location can receive services (1=yes, 0=no) - defaults to 1

parking_instructionsstringRequired

Optional: Parking instructions for service visits

preferred_visit_timestringRequired

Optional: Preferred time for service visits (morning, afternoon, evening)

special_instructionsstringRequired

Optional: General special instructions

Response headers

Hoststring

X-Powered-Bystring

Cache-Controlstring

Response

Created

dataobject

metaobject

Errors

422

Unprocessable Entity Error

Headers

Request

Response headers

Response

Errors