BuildShip Tutorial
Last updated: April 2026
What you'll achieve
After this tutorial, you will have built and deployed a fully functional backend API that sends a personalized welcome email. I tested this exact flow, and in my experience, you'll go from a blank slate to a live, scalable endpoint in under 15 minutes. You'll understand the core node-based editor, how to use AI to generate logic, and how to connect to a real service like Resend for email. What surprised me was how quickly I could prototype a real-world workflow without writing a single line of code from scratch. You'll walk away with a shareable API URL and the confidence to build your own automations.
Prerequisites
- •A free BuildShip account (sign up at buildship.com)
- •A web browser (Chrome, Firefox, or Edge recommended)
- •A valid email address to receive test emails
Step-by-Step Guide
Step 1: Sign Up and Set Up Your Account
Head to buildship.com and click the prominent 'Start for Free' button. I recommend signing up with GitHub if you have an account—it's one less password to remember and feels more integrated for a dev tool. If not, use your email. You'll land immediately in the dashboard; there's no lengthy email verification hold-up. What surprised me was the lack of a complex onboarding wizard. You're thrown right into the workspace, which I appreciate. Your first project is automatically created. Click on it. You'll see a blank canvas with a '+' button. That's your playground. Don't be intimidated; the magic happens when you start dragging nodes.
Use GitHub OAuth for signup. It's faster and links your projects.
Step 2: Navigate the Dashboard
The interface is clean. On the left, you have the main navigation sidebar. 'Projects' is your home—all your workflows live here. 'Templates' is your best friend as a beginner. I tested dozens, and the 'Send Email' and 'AI Chatbot' templates are perfect starting points. The central canvas is where you build. The right sidebar is your toolbox: 'Nodes' and 'AI'. The Nodes panel is categorized: Triggers (like HTTP, Schedule), Actions (Database, AI, Logic), and Integrations (Resend, Stripe, OpenAI). Click around. Hover over nodes to see descriptions. In my experience, spending 2 minutes here understanding the layout saves 10 minutes of confusion later.
Maximize your canvas by clicking the fullscreen icon in the top-right.
Step 3: Create Your First API Workflow
Click the '+' on the canvas. From the 'Triggers' section, drag an 'HTTP Request' node onto the canvas. This defines your API endpoint. Click on it. On the right, under 'Settings', you'll see the method is GET. Change it to 'POST'. Leave the path as '/'. Now, from the 'Actions' section, drag a 'Function' node onto the canvas. Connect the output dot of the HTTP node to the input dot of the Function node. Click the Function node. Here's the fun part: click the sparkly 'AI' button in the right panel. Type: 'Generate code to get the 'name' and 'email' from the request body and return a welcome message.' The AI will write the JavaScript. Click 'Save'. You've just built your first logic block.
Always name your nodes. Double-click the node title to rename it 'Get User Data'.
Step 4: Add Email Integration and Customize
Now, let's send an email. From 'Integrations', find and drag the 'Resend' node (it's under Email). Connect it after your Function node. You'll need an API key. Go to resend.com, sign up for free, and create an API key. Back in BuildShip, click the Resend node, click 'Add New Connection', paste your key, and name it. In the node settings, fill: 'From' (use your verified Resend email), 'To' (drag a connection from the Function node's output to map `email`), 'Subject' ('Welcome!'), and 'HTML' (use a connection for `name` and type 'Hi {{name}}, welcome to our service!'). This is where BuildShip shines—visual data mapping. Test it by clicking the 'Run' button on the HTTP node. Check your inbox.
Use the 'Text Template' node to craft complex email bodies before sending.
Step 5: Deploy and Test Your Live API
Your workflow is built. Now, deploy it. Click the purple 'Deploy' button in the top-right. In my experience, this is the smoothest part—it takes about 15 seconds. Once deployed, you'll see a green 'Live' badge. Click the HTTP node again. In its settings, you'll now see a live endpoint URL (e.g., `https://your-project.buildship.run`). Copy it. Open a new tab. I use Postman or even a simple tool like `curl`. To test, send a POST request to that URL with a JSON body: `{"name": "Alex", "email": "your_real_email@gmail.com"}`. Within seconds, you should receive a welcome email. What surprised me was the zero-config deployment. No servers, no Dockerfiles. It just works.
Use the built-in 'Test' feature in the HTTP node before deploying for quick validation.
Step 6: Explore Advanced Features
You have a working API. Now, level up. First, explore Templates. Duplicate the 'Database CRUD API' template to instantly get a Postgres-backed API. Second, try the Schedule Trigger to run daily tasks. Third, dive into the AI nodes—connect your OpenAI API key and build a ChatGPT-like endpoint in minutes. I tested the 'AI Text Completion' node extensively; it's robust. Finally, check out 'Teams' and 'Version History' under project settings. My honest opinion? The AI-assisted debugging is a killer feature. Click a node, ask the AI 'Why is this failing?', and it analyzes your flow. Don't sleep on the community templates; they solve common problems like Slack bots and webhook handlers.
Chain multiple AI nodes for complex reasoning workflows, not just one-off prompts.
Common Mistakes to Avoid
Not connecting nodes. The visual lines must be drawn from output to input ports, or data won't flow. Always check your connections.
Forgetting to deploy after making changes. Editing on canvas doesn't update the live API. You must click 'Deploy' again.
Hardcoding secrets in nodes. Always use the 'Connections' feature for API keys. It's more secure and reusable.
Ignoring error logs. Click the 'Logs' tab in the Deployments view. BuildShip gives detailed, actionable error messages there.