Actix Web CAPTCHA Integration
Set up an Actix Web CAPTCHA with a few lines of Rust. TrustCaptcha stops bot spam on logins, signups and contact forms, and a shared instance via web::Data plus a small async helper keep your handlers tidy. EU-hosted, GDPR-compliant, no image puzzles.
Quickstart
How the integration works
1. Create a CAPTCHA
Create a user account or log in with an existing one. Then create a new CAPTCHA or pick an existing one. If you want to try TrustCaptcha first, every plan comes with a 14-day free trial.
The CAPTCHA overview page shows your site key and license key, and you create your API key there. Add your website’s domains to the authorized domains in the CAPTCHA security rules so they can use your CAPTCHA.


2. Add the CAPTCHA widget to your form
Drop the TrustCaptcha widget into the HTML form your Actix Web handler serves. The widget runs the CAPTCHA in the background and adds a hidden tc-verification-token field on submit, which web::Form deserializes into your struct.
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>
<form method="post" action="/contact">
<input type="email" name="email" required>
<trustcaptcha-component sitekey="<your_site_key>"></trustcaptcha-component>
<button type="submit">Send</button>
</form>The CAPTCHA widget will then be displayed inside your form:

Need detailed information about the CAPTCHA widget integration?
Our documentation has the full widget reference, including themes, languages and custom design.
Read the documentation
3. Validate the token in your Actix Web handler
In your Actix Web handler, take the verification token from the form, look up the result via our Rust crate, and decide whether to accept the request.
First, install our TrustCaptcha Rust crate:
cargo add trustcaptcha@^3.0Then validate the token inside your Actix Web handler and act on the result:
use actix_web::{post, web, HttpResponse, Responder};
use serde::Deserialize;
use trustcaptcha::trust_captcha::TrustCaptcha;
#[derive(Deserialize)]
struct ContactForm {
email: String,
#[serde(rename = "tc-verification-token")]
tc_verification_token: String,
}
#[post("/contact")]
async fn submit(form: web::Form<ContactForm>) -> impl Responder {
let trust_captcha = match TrustCaptcha::builder("<your_api_key>").build() {
Ok(tc) => tc,
Err(_) => return HttpResponse::InternalServerError().body("CAPTCHA setup failed."),
};
let result = match trust_captcha.get_verification_result(&form.tc_verification_token).await {
Ok(r) => r,
Err(_) => return HttpResponse::BadRequest().body("CAPTCHA verification failed."),
};
if !result.verification_passed || result.score > 0.5 {
return HttpResponse::BadRequest().body("CAPTCHA verification failed.");
}
// CAPTCHA passed — process the request
HttpResponse::Ok().body("Thanks!")
}Need detailed information about the Actix Web CAPTCHA integration?
For full step-by-step instructions, including a shared web::Data<TrustCaptcha> setup and a reusable verify_token helper, please read our documentation.
Read the documentation
Other backend framework instead of Actix Web?
If you use a different framework, pick the matching recipe here. If your framework isn’t listed, your software developers can integrate the verification themselves using our documentation or ask our support team for a pre-built integration.
4. Test your integration
TrustCaptcha is now active. Send a test request and check that it goes through.

FAQs
Where does the Actix Web CAPTCHA check go?
How do I share a single TrustCaptcha across handlers?
Should I extract the CAPTCHA check into a custom Actix extractor?
Does the Rust SDK fit Actix Web's async runtime?
TrustCaptcha blocks spam and bots, not customers. No puzzles, GDPR-compliant, EU-hosted.


Protect your Actix Web application with TrustCaptcha in just a few steps!
- EU-hosted & GDPR-compliant
- No puzzles
- Try free for 14 days