Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In

    Devices

  • List devices

  • List device codes

  • Create device code

  • Get device code

  • Get device

  • Webhooks

  • device.code.paired

  • device.created

<- Devices webhooks

Devices webhooks

All versions ->

device createdBeta

EVENT

 device.created

Published when a Device is created.

Permissions:DEVICES_READ
Link to section

Event payload

Example code

Link to section

merchant_id

string

The merchant the newly created device belongs to.

Link to section

type

string

The type of event this represents. The value is "device.created".

Link to section

event_id

string

A UUID that uniquely identifies this device creation event.

Link to section

created_at

string

Read only The time when the device creation event was first created, in RFC 3339 format.

Link to section

data

The metadata associated with the device creation event.

Link to section

Examples

All versions ->

Response JSON

{ "merchant_id": "MLF2HW14529P1", "type": "device.created", "event_id": "e2744346-e23d-31e8-9f52-660116750760", "created_at": "2023-08-08T16:49:54.990909221Z", "data": { "type": "device", "id": "device:3136f66b-f4b0-3846-8722-7fcc55270e50", "object": { "device": { "id": "device:3136f66b-f4b0-3846-8722-7fcc55270e50", "attributes": { "type": "TERMINAL", "manufacturer": "SQUARE", "model": "T2", "name": "San Francisco Store - Device 901", "manufacturers_id": "3136f66b-f4b0-3846-8722-7fcc55270e50", "updated_at": "2023-08-08T16:49:54.990909221Z", "version": "9.9.3", "merchant_token": "MLF2HW14529P1" }, "components": [ { "type": "BATTERY", "battery_details": { "visible_percent": 11, "external_power": "AVAILABLE_INSUFFICIENT" } }, { "type": "CARD_READER", "card_reader_details": { "version": "8.5.6" } }, { "type": "ETHERNET", "ethernet_details": { "ip_address_v4": "109.208.212.40", "active": false } }, { "type": "WIFI", "wifi_details": { "ip_address_v4": "187.180.54.247", "ssid": "San Francisco Store Wifi", "secure_connection": "WPA/WPA2 PSK", "signal_strength": { "value": 3 }, "active": true } }, { "type": "APPLICATION", "application_details": { "application_type": "TERMINAL_API", "version": "8.6.1", "session_location": "LN6WR64FV0VEP", "device_code_id": "G5D3VSVAFYTPB" } }, { "type": "PRINTER" } ], "status": "AVAILABLE" } } } }