How do I set up geo permissions?
Learn how to set up geographical permiss...
Learn how to set up geographical permissions so that your GatewayAPI account can only send SMS messages to countries you have pre-approved.
This security measure ensures that even if your API keys should be compromised, your account cannot be used to send SMS messages to blocked countries, i.e. countries that are not on your list of allowed countries.
Please note that this feature is only applied to the REST API. Please also note that as the default setting when you first create your account, all countries are permitted. You have to actively choose your permitted countries if you do not wish for your account to be permitted to send SMS messages to all countries.
How to set it up
See our step-by-step guide below with al...
See our step-by-step guide below with all the details on how to set up geo permissions.
Step 1: Navigate to SMS Geo Permissions
...
Step 1: Navigate to SMS Geo Permissions
You can set up geo permissions from your dashboard by clicking on “Settings” → “SMS Geo Permissions”.
Step 2: Enable the “allowed countries” l...
Step 2: Enable the “allowed countries” list
Tick the box with the text “Yes, enable allowed countries list”
Step 3: Choose the countries you want to...
Step 3: Choose the countries you want to send messages to
You can either search for the countries in the search field or choose them from the list. You put a country on the “allowed” list by clicking on it so it appears in the column on the right. If you want to remove a country from the “allowed” list, you can simply click on it again.
Step 4: Save your changes
When you have ...
Step 4: Save your changes
When you have chosen which countries you wish to send SMS messages to, click on the “Save Changes” button at the top of the page.
Does it cost anything to use geo permissions?
No, this is a free feature.
No, this is a free feature.
What happens if you try sending an SMS to a blocked country?
If an SMS is sent to a country which has...
If an SMS is sent to a country which has not been put on the “allowed countries” list, this will result in a 422 HTTP error code – the SMS will not be delivered and will not be charged either. This also goes for bulk messages sent to a group of countries and one or more countries have not been marked as allowed countries. In that case, none of the messages will be sent or charged.
