Docs

address.updated

Occurs when an address is updated.

Occurs when an address is updated, for example when any of its address lines, city, region, postal code, or country change.

Payload includes the complete address entity.

event_idstringrequired
Example: evt_01gks14ge726w50ch2tmaw2a1x
Unique Paddle ID for this event, prefixed with evt_.
Pattern: ^evt_[a-z\d]{26}$
event_typestringrequired
Type of event sent by Paddle, in the format entity.event_type.
Values
+ Show all values
occurred_atstring (date-time)required
Example: 2024-10-12T07:20:50.52Z
RFC 3339 datetime string of when this event occurred.
notification_idstringrequired
Example: ntf_01ghbkd0frb9k95cnhwd1bxpvk
Unique Paddle ID for this notification, prefixed with ntf_.
Pattern: ^ntf_[a-z\d]{26}$
dataobjectrequired
New or changed entity.
idstringrequired
Example: add_01ghbm9egqcxtz4ap4dfg8dtaf
Unique Paddle ID for this address entity, prefixed with add_.
Pattern: ^add_[a-z\d]{26}$
customer_idstringrequired
Example: ctm_01ghbm8g2qxsjp07p5ywsy61cs
The ID of the customer this address belongs to.
Pattern: ^ctm_[a-z\d]{26}$
descriptionstring | nullrequired
Example: Paddle.com
Memorable description for this address.
Length: 1–1024
first_linestring | nullrequired
Example: 3811 Ditmars Blvd
First line of this address.
Length: 1–1024
second_linestring | nullrequired
Example: 18-29 Mora Street
Second line of this address.
Length: 1–1024
citystring | nullrequired
Example: Astoria
City of this address.
Length: 1–200
postal_codestring | nullrequired
Example: 11105-1803
ZIP or postal code of this address. Required for some countries.
Length: 1–200
regionstring | nullrequired
Example: NY
State, county, or region of this address.
Length: 1–200
country_codestringrequired
Example: GB
Two-letter ISO 3166-1 alpha-2 representation of a supported country.
Values
  • AD
    Andorra
  • AE
    United Arab Emirates
  • AG
    Antigua and Barbuda
  • AI
    Anguilla
  • AL
    Albania
+ Show all values
  • AM
    Armenia
  • AO
    Angola
  • AR
    Argentina
  • AS
    American Samoa
  • AT
    Austria
  • AU
    Australia
  • AW
    Aruba
  • AX
    Åland Islands
  • AZ
    Azerbaijan
  • BA
    Bosnia and Herzegovina
  • BB
    Barbados
  • BD
    Bangladesh
  • BE
    Belgium
  • BF
    Burkina Faso
  • BG
    Bulgaria
  • BH
    Bahrain
  • BI
    Burundi
  • BJ
    Benin
  • BL
    Saint Barthélemy
  • BM
    Bermuda
  • BN
    Brunei
  • BO
    Bolivia
  • BQ
    Caribbean Netherlands (Bonaire, Sint Eustatius, and Saba)
  • BR
    Brazil
  • BS
    Bahamas
  • BT
    Bhutan
  • BV
    Bouvet Island
  • BW
    Botswana
  • BZ
    Belize
  • CA
    Canada
  • CC
    Cocos Islands
  • CG
    Republic of Congo
  • CH
    Switzerland
  • CI
    Côte d'Ivoire (Ivory Coast)
  • CK
    Cook Islands
  • CL
    Chile
  • CM
    Cameroon
  • CN
    China
  • CO
    Colombia
  • CR
    Costa Rica
  • CV
    Cape Verde
  • CW
    Curaçao
  • CX
    Christmas Island
  • CY
    Cyprus
  • CZ
    Czechia (Czech Republic)
  • DE
    Germany
  • DJ
    Djibouti
  • DK
    Denmark
  • DM
    Dominica
  • DO
    Dominican Republic
  • DZ
    Algeria
  • EC
    Ecuador
  • EE
    Estonia
  • EG
    Egypt
  • EH
    Western Sahara
  • ER
    Eritrea
  • ES
    Spain
  • ET
    Ethiopia
  • FI
    Finland
  • FJ
    Fiji
  • FK
    Falkland Islands
  • FM
    Micronesia
  • FO
    Faroe Islands
  • FR
    France
  • GA
    Gabon
  • GB
    United Kingdom
  • GD
    Grenada
  • GE
    Georgia
  • GF
    French Guiana
  • GG
    Guernsey
  • GH
    Ghana
  • GI
    Gibraltar
  • GL
    Greenland
  • GM
    Gambia
  • GN
    Guinea
  • GP
    Guadeloupe
  • GQ
    Equatorial Guinea
  • GR
    Greece
  • GS
    South Georgia and the South Sandwich Islands
  • GT
    Guatemala
  • GU
    Guam
  • GW
    Guinea-Bissau
  • GY
    Guyana
  • HK
    Hong Kong
  • HM
    Heard Island and McDonald Islands
  • HN
    Honduras
  • HR
    Croatia
  • HU
    Hungary
  • ID
    Indonesia
  • IE
    Ireland
  • IL
    Israel
  • IM
    Isle of Man
  • IN
    India
  • IO
    British Indian Ocean Territory
  • IQ
    Iraq
  • IS
    Iceland
  • IT
    Italy
  • JE
    Jersey
  • JM
    Jamaica
  • JO
    Jordan
  • JP
    Japan
  • KE
    Kenya
  • KG
    Kyrgyzstan
  • KH
    Cambodia
  • KI
    Kiribati
  • KM
    Comoros
  • KN
    Saint Kitts and Nevis
  • KR
    South Korea
  • KW
    Kuwait
  • KY
    Cayman Islands
  • KZ
    Kazakhstan
  • LA
    Lao People's Democratic Republic (Laos)
  • LB
    Lebanon
  • LC
    Saint Lucia
  • LI
    Liechtenstein
  • LK
    Sri Lanka
  • LR
    Liberia
  • LS
    Lesotho
  • LT
    Lithuania
  • LU
    Luxembourg
  • LV
    Latvia
  • MA
    Morocco
  • MC
    Monaco
  • MD
    Moldova
  • ME
    Montenegro
  • MF
    Saint Martin
  • MG
    Madagascar
  • MH
    Marshall Islands
  • MK
    Macedonia
  • MN
    Mongolia
  • MO
    Macao
  • MP
    Northern Mariana Islands
  • MQ
    Martinique
  • MR
    Mauritania
  • MS
    Montserrat
  • MT
    Malta
  • MU
    Mauritius
  • MV
    Maldives
  • MW
    Malawi
  • MX
    Mexico
  • MY
    Malaysia
  • MZ
    Mozambique
  • NA
    Namibia
  • NC
    New Caledonia
  • NE
    Niger
  • NF
    Norfolk Island
  • NG
    Nigeria
  • NL
    Netherlands
  • NO
    Norway
  • NP
    Nepal
  • NR
    Nauru
  • NU
    Niue
  • NZ
    New Zealand
  • OM
    Oman
  • PA
    Panama
  • PE
    Peru
  • PF
    French Polynesia
  • PG
    Papua New Guinea
  • PH
    Philippines
  • PK
    Pakistan
  • PL
    Poland
  • PM
    Saint Pierre and Miquelon
  • PN
    Pitcairn
  • PR
    Puerto Rico
  • PS
    Palestinian territories
  • PT
    Portugal
  • PW
    Palau
  • PY
    Paraguay
  • QA
    Qatar
  • RE
    Reunion
  • RO
    Romania
  • RS
    Republic of Serbia
  • RW
    Rwanda
  • SA
    Saudi Arabia
  • SB
    Solomon Islands
  • SC
    Seychelles
  • SE
    Sweden
  • SG
    Singapore
  • SH
    Saint Helena
  • SI
    Slovenia
  • SJ
    Svalbard and Jan Mayen
  • SK
    Slovakia
  • SL
    Sierra Leone
  • SM
    San Marino
  • SN
    Senegal
  • SR
    Suriname
  • ST
    São Tomé and Príncipe
  • SV
    El Salvador
  • SX
    Sint Maarten
  • SZ
    Swaziland
  • TC
    Turks and Caicos Islands
  • TD
    Chad
  • TF
    French Southern and Antarctic Lands
  • TG
    Togo
  • TH
    Thailand
  • TJ
    Tajikistan
  • TK
    Tokelau
  • TL
    Timor-Leste
  • TM
    Turkmenistan
  • TN
    Tunisia
  • TO
    Tonga
  • TR
    Turkey
  • TT
    Trinidad and Tobago
  • TV
    Tuvalu
  • TW
    Taiwan
  • TZ
    Tanzania
  • UA
    Ukraine
  • UG
    Uganda
  • UM
    United States Minor Outlying Islands
  • US
    United States
  • UY
    Uruguay
  • UZ
    Uzbekistan
  • VA
    Holy See (Vatican City)
  • VC
    Saint Vincent and the Grenadines
  • VG
    British Virgin Islands
  • VI
    U.S. Virgin Islands
  • VN
    Vietnam
  • VU
    Vanuatu
  • WF
    Wallis and Futuna
  • WS
    Samoa
  • XK
    Kosovo
  • YT
    Mayotte
  • ZA
    South Africa
  • ZM
    Zambia
custom_dataobject | nullrequired
Example: {"customer_reference_id":"abcd1234"}
Your own structured key-value data.
statusstringrequired
Whether this entity can be used in Paddle.
Values
  • active
    Entity is active and can be used.
  • archived
    Entity is archived, so can't be used.
import_metaobject | nullrequired
Import information for this entity. null if this entity is not imported.
external_idstring | null
Example: 9b95b0b8-e10f-441a-862e-1936a6d818ab
Reference or identifier for this entity from the provider where it was imported from.
Length: 1–200
imported_fromstringrequired
Example: paddle_classic
Name of the platform or provider where this entity was imported from.
Length: 1–200
created_atstring (date-time)required
Example: 2024-10-12T07:20:50.52Z
RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
updated_atstring (date-time)required
Example: 2024-10-13T07:20:50.52Z
RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
address.updated
{
"event_id": "evt_01hv8gygr4t0xrb2v821t7x9vk",
"event_type": "address.updated",
"occurred_at": "2024-04-12T06:47:02.148531Z",
"notification_id": "ntf_01hv8gygyqp6hyjjxmmag28m6p",
"data": {
"id": "add_01hv8gq3318ktkfengj2r75gfx",
"city": "San Jose",
"region": "CA",
"status": "active",
"created_at": "2024-04-12T06:45:53.267Z",
"first_line": "5400 E Washington Drive, Floor 2",
"updated_at": "2024-04-12T06:47:01.533006Z",
"custom_data": {
"crm_id": "08bcfb7a-41d8-4747-9ade-3d885c287d0f"
},
"customer_id": "ctm_01hv6y1jedq4p1n0yqn5ba3ky4",
"description": "California Office",
"import_meta": null,
"postal_code": "95314",
"second_line": null,
"country_code": "US"
}
}

Was this page helpful?