API Response Codes

Refer to the below response code glossary to help you troubleshoot any errors.

Glossary
Response Code
Messages
JavaScript Web API Explanation(s)
REST API Explanation(s)
200 OK
The request was successful!
N/A
N/A
400 Bad Request 
Participant cannot join this campaign.
The participant was prevented from being added to the campaign (please check that your campaign's anti-fraud settings are not set to Strict, or that you do not have the email or IP address blacklisted)
N/A
401 Unauthorized
Participant authentication is required.
If an existing participant is trying to access their account, they need to first authenticate (by logging in via one-time access token link in email)
N/A
401 Failed to add participant
Participant was not able to join this campaign.
The person may be a high-risk fraudster, and has been blocked from entering the campaign. Learn more about how GrowSurf's anti-fraud system works.
N/A
402
Usage limit exceeded
N/A
N/A
403 Forbidden
1.You are not allowed to perform that action.
2.No valid participant access token provided.
​
1.This may be due to the URL not matching what is configured for your campaign. Make sure to check your whitelisted URLs as well. Any URLs that makes excessive unauthorized requests to your GrowSurf campaign may be blocked. Please reach out to [email protected] for assistance.
2.If an existing participant is trying to access their account, they need to first authenticate (by logging in via one-time access token link in email)
3.Your campaign may be blocked if you were a previously paid customer who downgraded and subscribed again.  Please reach out to [email protected] for assistance.
​
1.Your API key may be revoked or contain a typo, or you may be trying to interact with another user's campaign or participant data (which is not allowed).
404 Resource Not Found
The requested resource does not exist.
You may be trying to request a resource that does not exist or was deleted.
You may be trying to request a resource that does not exist or was deleted.
409 Conflict Duplicate Request
Conflicting duplicate request.
If a request is made but has not finished and that exact same request is made.
​
More details on the specific request will be provided within the returned error.
N/A
429 Too Many Requests
You have reached your <rate> limit
You have reached the rate limit.
You have sent too many requests in a given time OR You have reached the usage limit in your current plan.

See Rate Limits and Max Connections for more details on rate limits.
5XX Internal Server Error
The GrowSurf server is inaccessible or offline -- that's our fault! Check for updates on our status page.
N/A
N/A

API Guidelines

Next - Integrate

JavaScript Web API

Last modified 3mo ago

Response Code	Messages	JavaScript Web API Explanation(s)	REST API Explanation(s)
`200 OK`	The request was successful!	N/A	N/A
`400 Bad Request`	Participant cannot join this campaign.	The participant was prevented from being added to the campaign (please check that your campaign's anti-fraud settings are not set to Strict, or that you do not have the email or IP address blacklisted)	N/A
`401 Unauthorized`	Participant authentication is required.	If an existing participant is trying to access their account, they need to first authenticate (by logging in via one-time access token link in email)	N/A
`401 Failed to add participant`	Participant was not able to join this campaign.	The person may be a high-risk fraudster, and has been blocked from entering the campaign. Learn more about how GrowSurf's anti-fraud system works.	N/A
`402`	Usage limit exceeded	N/A	N/A
`403 Forbidden`	1. You are not allowed to perform that action. 2. No valid participant access token provided.	1. This may be due to the URL not matching what is configured for your campaign. Make sure to check your whitelisted URLs as well. Any URLs that makes excessive unauthorized requests to your GrowSurf campaign may be blocked. Please reach out to [email protected] for assistance. 2. If an existing participant is trying to access their account, they need to first authenticate (by logging in via one-time access token link in email) 3. Your campaign may be blocked if you were a previously paid customer who downgraded and subscribed again. Please reach out to [email protected] for assistance.	1. Your API key may be revoked or contain a typo, or you may be trying to interact with another user's campaign or participant data (which is not allowed).
`404 Resource Not Found`	The requested resource does not exist.	You may be trying to request a resource that does not exist or was deleted.	You may be trying to request a resource that does not exist or was deleted.
`409 Conflict Duplicate Request`	Conflicting duplicate request.	If a request is made but has not finished and that exact same request is made. More details on the specific request will be provided within the returned error.	N/A
`429 Too Many Requests`	You have reached your <rate> limit	You have reached the rate limit.	You have sent too many requests in a given time OR You have reached the usage limit in your current plan. See Rate Limits and Max Connections for more details on rate limits.
`5XX Internal Server Error`	The GrowSurf server is inaccessible or offline -- that's our fault! Check for updates on our status page.	N/A	N/A