We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

for Partners

Callbacks•Best practices•Troubleshooting checklist

Callbacks troubleshooting checklist

Here, you can find the key points to verify after you set up your callbacks. Review this checklist before you go live with your callback URLs.

Allowlist Adjust's server IPs. Adjust sends all callbacks from certain subnets. Learn more about Adjust’s server IPs and the full list of IP addresses to allowlist.
Check your callback URL/endpoint. Make sure that you have specified the server endpoint URL/domain name as the callback URL. Adjust does not support an IP address in the callback URL for security reasons.
Append correct callback parameters. To avoid missing callbacks, make sure to append callback parameters (for example, install_callback) to all click URLs.
Make sure your callback URL is formatted correctly. Check that special characters, such as ampersands (&) and spaces are correctly placed and properly encoded (or unencoded).
Check your placeholders. Use our Adjust placeholders page to confirm that your placeholders are correct.
Review your parameters. Make sure your internal system recognizes the parameters you use.
Use https for all callback URLs. Some raw data can only be sent to HTTPS endpoints. Use https:// for all callback URLs.
Ensure that your callbacks do not exceed 1 MB. Adjust can forward callbacks up to 1 MB. If your callback exceeds 1 MB, your callbacks will not work.

Automatic retry of failed callbacks

If your server endpoint is unavailable or returns a 5xx HTTP response, Adjust tries to resend the callback up to six times over the next 24 hours. To protect data security, our callback server records the HTTPS response of your endpoint and doesn't follow any redirects. If your server goes down and you need historical user data, we always do our best to recall this data retroactively.