Locations: Parse International Address
Use this action to verify an international address and save each portion into a standardized format.
This is a premium action. By default, a premium action is not available in a team as there is an additional fee associated with it. Please contact PagerDuty Support to begin working with this action, or check the Premium Actions article.
Use Case
Convert an addressed entered by a user into one field into its components prior to creating a customer record in an integrated system
How to configure this action
Fields for this action
-
Street address
- Reference the field in
{{field-name}}
format that contains the address you are trying to parse
- Reference the field in
-
Country
- Country Name or ISO classification (ISO-3, ISO-2 or ISO-N). Address validation will fail if this is missing. (For example, Germany, DEU, DE, or 276)
-
Return field name
- Name the field to store the action’s output. The output field can be referenced
What will this output?
The expected output for this action is the parsed result of the address stored in the return field name defined in configuration. The field will be a JSON field with the structured address.
If the address can be parsed, the JSON will follow this format:
{
"address-1": "42A Torbrex Road",
"address-2": "Stirling",
"address-3": "FK7 9HH",
"country": "UK",
"status": "completed",
"street-address": "42A Torbrex Road, Stirling, FK7 9HH, UK",
"administrative-area": "Stirlingshire",
"country-iso-3": "GBR",
"locality": "Stirling",
"postal-code": "FK7 9HH",
"postal-code-short": "FK7 9HH",
"premise": "42A",
"premise-number": "42A",
"thoroughfare": "Torbrex Road",
"thoroughfare-name": "Torbrex",
"thoroughfare-trailing-type": "Road"
}
If the address could not be parsed, the JSON will follow this format:
{
"address-verified": false,
"status": "failed"
}
Tips
- Use the Field: Field formulas action to convert the JSON into separate fields
- If you’re not able to find the country, try running this action multiple times with different countries until the address is successfully parsed.
- Build logic into your process so that when the address cannot be parsed, a task is assigned to a user to manually parse the address.
Supported Countries
A list of all supported countries is listed below. This is useful to copy and paste into a Single Choice field:
Afghanistan
Åland Islands
Albania
Algeria
American Samoa
Andorra
Angola
Anguilla
Antarctica
Antigua Barbuda
Argentina
Armenia
Aruba
Australia
Austria
Azerbaijan
Bahamas
Bahrain
Bangladesh
Barbados
Belarus
Belgium
Belize
Benin
Bermuda
Bhutan
Bolivia
Bonaire
Bosnia Herzegovina
Botswana
Brazil
British Indian Ocean Territory
British Virgin Islands
Brunei Darussalam
Bulgaria
Burkina Faso
Burundi
Cambodia
Cameroon
Canada
Cape Verde Islands
Cayman Islands
Central African Republic
Chad
Chile
China
Christmas Island
Cocos (Keeling) Islands
Colombia
Comoros
Congo
Cook Islands
Costa Rica
Croatia
Cuba
Curacao
Cyprus
Czech Republic
Denmark
Djibouti
Dominica
Dominican Republic
Ecuador
Egypt
El Salvador
Equatorial Guinea
Eritrea
Estonia
Ethiopia
Falkland Islands
Faroe Islands
Fiji
Finland
France
French Guiana
French Polynesia
French Southern Territories
Gabon
Gambia
Georgia
Germany
Ghana
Gibraltar
Greece
Greenland
Grenada
Guadeloupe
Guam
Guatemala
Guernsey
Guinea
Guinea-Bissau
Guyana
Haiti
Holy See
Honduras
Hong Kong
Hungary
Iceland
India
Indonesia
Iran
Iraq
Ireland
Isle of Man
Israel
Italy
Ivory Coast
Jamaica
Japan
Jersey
Jordan
Kazakhstan
Kenya
Kiribati
Korea
Kuwait
Kyrgyzstan
Laos
Latvia
Lebanon
Lesotho
Liberia
Libya
Liechtenstein
Lithuania
Luxembourg
Macao
Macedonia
Madagascar
Malawi
Malaysia
Maldives
Mali
Malta
Marshall Islands
Martinique
Mauritania
Mauritius
Mayotte
Mexico
Micronesia
Moldova
Monaco
Mongolia
Montenegro
Montserrat
Morocco
Mozambique
Myanmar
Namibia
Nauru
Nepal
Netherlands Antilles
Netherlands
New Caledonia
New Zealand
Nicaragua
Niger
Nigeria
Niue
Norfolk Island
North Korea
Northern Mariana Islands
Norway
Oman
Pakistan
Palau
Palestinian Territory
Panama
Papua New Guinea
Paraguay
Peru
Philippines
Pitcairn Island
Poland
Portugal
Puerto Rico
Qatar
Réunion
Romania
Russia
Rwanda
Saint Barthélemy
Saint Helena
Saint Kitts and Nevis
Saint Lucia
Saint Martin
Saint Pierre and Miquelon
Saint Vincent and the Grenadines
Samoa
San Marino
Sao Tome and Principe
Saudi Arabia
Senegal
Serbia
Seychelles
Sierra Leone
Singapore
Sint Maarten (Dutch)
Slovakia
Slovenia
Solomon Islands
Somalia
South Africa
South Georgia and the South Sandwich Islands
South Sudan
Spain
Sri Lanka
Sudan
Suriname
Svalbard and Jan Mayen Islands
Swaziland
Sweden
Switzerland
Syria
Taiwan
Tajikistan
Tanzania
Thailand
Timor-Leste (formerly East Timor)
Togo
Tokelau
Tonga
Trinidad and Tobago
Tunisia
Turkey
Turkmenistan
Turks and Caicos Islands
Tuvalu
Uganda
Ukraine
United Arab Emirates
United Kingdom
United States Minor Outlying Islands
United States Virgin Islands
United States
Uruguay
Uzbekistan
Vanuatu
Venezuela
Vietnam
Wallis and Futuna Islands
Western Sahara
Yemen
Zambia
Zimbabwe
Thanks for your feedback
We update the Help Center daily, so expect changes soon.
Link Copied
Paste this URL anywhere to link straight to the section.