send_http_post

HTTP: POST

🥷 Try it live — no local setup. ICP Ninja is a web-based IDE that builds and deploys this project to the mainnet for free, right in your browser. Click the badge above, or hit Deploy if you're already in Ninja. To build and run it locally instead, follow the steps below.

This example demonstrates how to use the ICP HTTPS outcalls feature to make a POST request from a Rust canister. It sends a plain-text body to postman-echo.com/post, which echoes back the request as JSON, allowing you to verify the POST body and headers were sent correctly.

For a deeper understanding of HTTPS outcalls on the IC, see the HTTPS outcalls documentation.

Build and deploy from the command line

Prerequisites

• Node.js v18+
• icp-cli: npm install -g @icp-sdk/icp-cli @icp-sdk/ic-wasm
• Rust with wasm32-unknown-unknown target: rustup target add wasm32-unknown-unknown

Install

git clone https://github.com/dfinity/examples
cd examples/rust/send_http_post

Deploy and test

icp network start -d
icp deploy
bash test.sh
icp network stop

Security considerations and best practices

Refer to the security best practices for information on security and best practices for your ICP app.