✦ 30+ questions answered

Frequently asked questions

Can't find your answer? Contact us →

Yes. PinForge AI uses only the official Pinterest API v5 with proper OAuth2. We enforce hard limits: max 15 pins per account per day and randomized 15–60 minute delays between posts. These rules are enforced server-side — they can't be accidentally disabled. We have zero accounts banned since launch.
The risk is extremely low because we operate through Pinterest's official API — the same way Tailwind, Buffer, and other approved tools work. Unlike tools that use browser automation or scraping, we have explicit permission from Pinterest to use their API. Our safety limits further reduce any risk by keeping posting behavior well within normal human patterns.
Never. We use OAuth2, so you log in through Pinterest's own consent screen — we never even see your password. We receive and store only the access token that Pinterest issues after you approve, along with a refresh token to keep the connection alive. This is the same authorization method used by all major approved Pinterest partners.
The 15 pins/day cap is our safety limit, not Pinterest's hard API limit. It's based on research into what keeps accounts healthy for the long term. Pinterest itself recommends 5–25 fresh pins per day, so we stay well within that range. This limit is enforced server-side and cannot be raised via the UI — it's there to protect your account.
Before posting any pin, we compute a SHA-256 hash of the title and description combined. If the same account has already posted a pin with that exact title+description combination before, the new pin is automatically skipped with status "duplicate" — and you're notified in the audit log. This prevents Pinterest from flagging your account for spam.
PinForge AI uses the official Pinterest API v5 — the latest version released by Pinterest. All endpoints we use are documented in Pinterest's official developer documentation at developers.pinterest.com. We use only board listing, board creation, and pin creation endpoints. No scraping, no unofficial endpoints, no browser automation.
You need a Pinterest account that has agreed to Pinterest's developer terms. A Business account is strongly recommended because it gives you access to analytics, richer pin formats, and is required for some API features. You can convert any personal account to a Business account for free in Pinterest's settings.
We request these OAuth scopes: boards:read (list your boards), boards:write (create new boards), pins:read (read your existing pins), pins:write (create new pins), and user_accounts:read (read your username and profile). We request only what's necessary — nothing more. You'll see exactly these scopes listed on Pinterest's consent screen when you connect.
Pinterest access tokens expire. PinForge AI automatically detects when your token is about to expire (within 5 minutes) and refreshes it using the refresh token before attempting any post. This happens in the background — you never need to reconnect your account manually unless you revoke access from Pinterest's settings.
We support three AI providers: Google Gemini (Gemini 1.5 Flash — free tier, recommended), OpenAI (GPT-4o Mini — paid), and DeepSeek (deepseek-chat — budget-friendly paid). You choose the provider in your Settings page. For Gemini on the free tier, you get 1,500 requests per day at no cost — more than enough for most users.
Yes, you supply your own AI API key in Settings. This is intentional — it means AI costs go to your provider account directly (we don't mark them up), and you're not limited by our shared API quota. Getting a Gemini API key from aistudio.google.com is free and takes about 2 minutes.
Absolutely. AI generates the content but you always review and approve before adding it to the queue. The title, description, hashtags, and alt text are all editable fields — you can change any word, add your brand voice, or completely rewrite them. The AI is a starting point, not the final word.
English by default. You can specify your target language in the product description field — for example, "write in Spanish" or "escribir en español" — and the AI will generate content in that language. Gemini 1.5 Flash and GPT-4o Mini both support 40+ languages.
Yes, if you're using Gemini or GPT-4o Mini (both multimodal models), your image is sent to the AI as base64 along with your product description. This allows the AI to generate alt text that accurately describes the visual content, and to pick hashtags that match what's actually in the image — not just your text description.
When you add a pin to the queue, PinForge AI calculates its scheduled time as: the time of the last queued pin + a random delay between 15 and 60 minutes. The background scheduler checks the queue every 2 minutes and posts anything that's due. You can see every scheduled time in the Queue tab, and remove any item that hasn't posted yet.
The item is marked FAILED with the exact error message from Pinterest — for example, "board not found", "token expired", or "Pinterest rate limit hit". It's logged in the audit trail with a timestamp. Failed items are NOT automatically retried (to avoid hammering the API), but you can see the reason and decide what to do — fix the issue and re-queue if needed.
Currently, PinForge AI schedules pins with automatic randomized delays for safety. Specific time-of-day scheduling (e.g., "post at 9 AM EST every day") is on our roadmap for Phase 2. The current approach is intentionally randomized to maximize account safety.
Currently each pin upload targets one board. Multi-board posting (same image to multiple boards) is planned for Phase 2. As a workaround, you can upload the same image multiple times and select different boards each time — each will be queued separately with spaced delays.
Yes. The scheduler runs in the backend (on Railway), not in your browser. Once you've added pins to the queue, you can close the browser completely and PinForge AI will continue posting on schedule 24/7. Your browser only interacts with the dashboard — the actual posting is server-side.
Yes. The Starter plan is free permanently — no credit card required, no trial expiry, no hidden upgrade pressure. It gives you 1 Pinterest account and 5 pins/day with Gemini AI. If you need more accounts or higher volume, the Pro plan starts at $19/month.
Yes. If you're not satisfied within 14 days of your first paid payment, contact us at support@pinforgeai.com and we'll issue a full refund — no questions asked. After 14 days, refunds are considered on a case-by-case basis.
We accept all major credit and debit cards (Visa, Mastercard, American Express, Discover) processed securely by Stripe. We plan to add PayPal for Agency customers in the near future.
Yes. Upgrade anytime — the new plan takes effect immediately and you're prorated for the remainder of your current billing period. Downgrade anytime — the change takes effect at the end of your current billing period. No penalties or fees for changing plans.
Yes. Annual billing saves 20% — Pro goes from $19/month to $15/month ($180/year), Agency goes from $49/month to $39/month ($468/year). You can toggle between monthly and annual on the pricing page to see the difference.
Starter: 1 account. Pro: up to 5 accounts. Agency: unlimited. Each account has its own isolated queue, schedule, daily cap, and analytics. Connecting a new account takes about 30 seconds via the official OAuth flow.
Yes, on the Agency plan you can connect unlimited Pinterest accounts — including client accounts. Your client clicks the OAuth connect button, authorizes PinForge AI, and their account appears in your dashboard. They can revoke access from their Pinterest settings at any time.
The account is marked inactive in our database. All queued pins for that account are paused. The access token is no longer used. Your posting history and queue data are retained for 30 days in case you reconnect. You can permanently delete all data for an account by contacting support.
We accept JPG, JPEG, PNG, and WEBP up to 20MB per file. Images are automatically resized and center-cropped to 1000×1500px (Pinterest's recommended 2:3 ratio) and re-encoded as optimized JPEG at 88% quality. EXIF metadata (including GPS location data) is stripped before processing.
Your account data, Pinterest tokens, pin queue, and history are stored in a Supabase PostgreSQL database hosted on AWS. Uploaded and processed images are stored on the backend server filesystem. We're working on moving images to Supabase Storage for better durability. All data is encrypted at rest.
We target 99.9% uptime for the backend scheduler. If the backend is down when a pin is due, it will be posted as soon as the service recovers (within a few minutes). We monitor uptime continuously and publish incidents on our status page.
Yes. We collect only the data necessary to provide the service. We don't sell user data. You can request deletion of all your data by contacting us at privacy@pinforgeai.com. Supabase (our database provider) is GDPR compliant and processes data in EU regions upon request. See our full Privacy Policy for details.
Data export is on our Phase 2 roadmap. Currently, you can see all your posting history in the Analytics page. For a full data export, contact support@pinforgeai.com and we'll provide a CSV export of your queue and history within 5 business days.

Still have questions?

Contact us →