Skip to main content
POST
/
v1
/
homes
/
create
create home
curl --request POST \
  --url https://api.example.com/v1/homes/create \
  --header 'Content-Type: application/json' \
  --header 'x-ws-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "userId": "<string>",
  "UtilityId": "<string>",
  "utilityId": "<string>",
  "ratePlanId": "<string>",
  "unstructuredAddress": "<string>",
  "clientId": "<string>",
  "country": "<string>",
  "city": "<string>",
  "zipcode": "<string>",
  "streetAddress": "<string>",
  "solarInfo": {},
  "carbonSignalIntensity": "LOW",
  "meterId": "<string>",
  "meterIdSource": "<string>",
  "enabled": true,
  "channelPartnerId": "<string>"
}
'
{
  "id": "<string>",
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>",
  "energyMarketBiddingEnabled": true,
  "carbonSignalIntensity": "LOW",
  "name": "<string>",
  "userId": "<string>",
  "UtilityId": "<string>",
  "ratePlanId": "<string>",
  "unstructuredAddress": "<string>",
  "timezone": "<string>",
  "country": "<string>",
  "city": "<string>",
  "zipcode": "<string>",
  "streetAddress": "<string>",
  "meterId": "<string>",
  "meterIdSource": "<string>",
  "enabled": true,
  "channelPartnerId": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.wattshift.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

x-ws-api-key
string
header
required

Headers

x-ws-api-key
string

WattShift API Key

Body

application/json
name
string
required

The name of the home

Required string length: 1 - 255
userId
string

The ID of the owner of the home

UtilityId
string
deprecated

Deprecated utility ID

utilityId
string

The utility ID

ratePlanId
string | null

The rate plan ID

unstructuredAddress
string

The unstructured address

clientId
string

The client ID

country
string

The country

city
string

The city

zipcode
string

The zip code

streetAddress
string

The street address

solarInfo
object

Solar installation information

carbonSignalIntensity
enum<string>

The carbon signal intensity

Available options:
LOW,
MEDIUM,
HIGH
meterId
string
meterIdSource
string
enabled
boolean

This is to check if the home is enabled

channelPartnerId
string

Optional tracking for channel partners (requires using a valid ID)

Response

200 - application/json
id
string
required
createdAt
any
required
updatedAt
any
required
energyMarketBiddingEnabled
boolean
required
carbonSignalIntensity
enum<string>
required
Available options:
LOW,
MEDIUM,
HIGH
name
string | null
userId
string | null
UtilityId
string | null
ratePlanId
string | null
unstructuredAddress
string | null
timezone
string | null
country
string | null
city
string | null
zipcode
string | null
streetAddress
string | null
meterId
string | null
meterIdSource
string | null
enabled
boolean | null
channelPartnerId
string | null