{"id":35451649,"url":"https://github.com/silverassist/contact-form-to-api","last_synced_at":"2026-03-03T05:06:27.023Z","repository":{"id":309773671,"uuid":"1036793085","full_name":"SilverAssist/contact-form-to-api","owner":"SilverAssist","description":"Transform your WordPress contact forms into powerful data collection tools that automatically send submissions to your favorite CRM, email marketing service, or any external API endpoint.","archived":false,"fork":false,"pushed_at":"2026-03-02T19:58:30.000Z","size":859,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-02T23:08:22.042Z","etag":null,"topics":["contact-form-7","contact-form-7-integration","wordpress","wordpress-plugin"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SilverAssist.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-12T15:35:28.000Z","updated_at":"2026-03-02T19:58:33.000Z","dependencies_parsed_at":"2025-08-13T19:50:54.641Z","dependency_job_id":null,"html_url":"https://github.com/SilverAssist/contact-form-to-api","commit_stats":null,"previous_names":["silverassist/contact-form-to-api"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/SilverAssist/contact-form-to-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SilverAssist%2Fcontact-form-to-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SilverAssist%2Fcontact-form-to-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SilverAssist%2Fcontact-form-to-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SilverAssist%2Fcontact-form-to-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SilverAssist","download_url":"https://codeload.github.com/SilverAssist/contact-form-to-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SilverAssist%2Fcontact-form-to-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30032410,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T03:27:35.548Z","status":"ssl_error","status_checked_at":"2026-03-03T03:27:09.213Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["contact-form-7","contact-form-7-integration","wordpress","wordpress-plugin"],"created_at":"2026-01-03T03:23:12.541Z","updated_at":"2026-03-03T05:06:27.011Z","avatar_url":"https://github.com/SilverAssist.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CF7 to API\n\n**🚀 Connect your Contact Form 7 forms to any API effortlessly!**\n\nTransform your WordPress contact forms into powerful data collection tools that automatically send submissions to your favorite CRM, email marketing service, or any external API endpoint.\n\n[![WordPress](https://img.shields.io/badge/WordPress-6.5%2B-blue)](https://wordpress.org)\n[![Contact Form 7](https://img.shields.io/badge/Contact%20Form%207-Required-green)](https://wordpress.org/plugins/contact-form-7/)\n[![PHP](https://img.shields.io/badge/PHP-8.2%2B-purple)](https://php.net)\n[![License](https://img.shields.io/badge/license-Polyform--Noncommercial--1.0.0-blue.svg)](LICENSE)\n\n\u003e **📢 Trademark Notice:** This plugin extends the functionality of Contact Form 7. \"Contact Form 7\" is a trademark of Rock Lobster, LLC. This plugin is an independent extension and is not affiliated with, endorsed by, or sponsored by the Contact Form 7 project or Rock Lobster, LLC. We use \"CF7\" (an unofficial abbreviated form) in our plugin name in compliance with the [Contact Form 7 trademark policy](https://contactform7.com/trademark-policy/).\n\n---\n\n## ✨ What This Plugin Does\n\n**CF7 to API** seamlessly connects your existing Contact Form 7 forms with external APIs. No coding required – just configure, map your fields, and you're ready to go!\n\n### 🎯 Perfect For:\n- **CRM Integration**: Send leads directly to Salesforce, HubSpot, Pipedrive, etc.\n- **Email Marketing**: Add subscribers to Mailchimp, ConvertKit, ActiveCampaign\n- **Custom Applications**: Connect to your own business applications and databases\n- **Third-Party Services**: Integrate with Slack, Zapier, webhooks, and more\n\n---\n\n## 🌟 Key Features\n\n### 🔧 **Easy Setup**\n- **No Code Required**: Configure everything through a simple interface\n- **Form-Specific Settings**: Each form can have its own API configuration\n- **Global Settings**: Configure plugin-wide retry limits, logging, and data retention\n- **Live Testing**: Test your API connections before going live\n\n### 🔄 **Flexible Data Mapping**\n- **Field Mapping**: Map any Contact Form 7 field to any API parameter\n- **Multiple Formats**: Send data as JSON, XML, or form parameters\n- **Custom Headers**: Add authentication tokens, API keys, and custom headers\n\n### 🚀 **Reliable Delivery**\n- **Multiple HTTP Methods**: Support for GET, POST, PUT, PATCH requests\n- **Retry Logic**: Automatic retries if API calls fail\n- **Manual Retry**: Retry failed requests directly from the admin interface\n- **Error Handling**: Graceful handling of API errors without breaking your forms\n\n### 📊 **Advanced Monitoring \u0026 Analytics**\n- **API Request Logs**: Complete history of all API requests with status, response times, and data\n- **Dashboard Widget**: At-a-glance statistics on your WordPress dashboard\n- **Date Range Filters**: Filter logs by today, yesterday, last 7/30 days, or custom ranges\n- **Export Logs**: Export your API logs to CSV or JSON for analysis\n- **Debug Mode**: See exactly what data is being sent to your APIs\n\n### ⚙️ **Global Settings**\n- **Retry Configuration**: Set maximum retries per request and hourly rate limits\n- **Sensitive Data Protection**: Configure patterns for automatic data anonymization\n- **Logging Control**: Enable/disable API logging globally\n- **Log Retention**: Automatic cleanup of old logs (7, 14, 30, 60, or 90 days)\n\n---\n\n## 🚀 Quick Start\n\n### Step 1: Install \u0026 Activate\n1. Install the plugin from WordPress admin or upload manually\n2. Make sure **Contact Form 7** is installed and activated\n3. Activate **CF7 to API**\n\n### Step 2: Configure Your First Integration\n1. **Edit your Contact Form 7 form**\n2. Click on the **\"API Integration\"** tab\n3. **Add your API endpoint URL**\n4. **Choose HTTP method** (usually POST)\n5. **Add headers** (like Authorization tokens)\n\n### Step 3: Map Your Fields\n1. **Select form fields** you want to send\n2. **Map them to API parameters**\n3. **Set data format** (JSON, XML, or form data)\n\n### Step 4: Test \u0026 Go Live\n1. **Use the test feature** to verify everything works\n2. **Save your configuration**\n3. **Your form is now connected!** 🎉\n\n---\n\n## 📊 Admin Dashboard \u0026 Monitoring\n\n### Dashboard Widget\nOnce activated, a **CF7 to API Statistics** widget appears on your WordPress dashboard showing:\n- **Total Requests**: Number of API calls in the last 24 hours\n- **Success Rate**: Percentage of successful submissions\n- **Avg Response Time**: Average API response time\n\n### API Logs\nAccess detailed logs at **Settings → Silver Assist → CF7 to API → API Logs**:\n- View all API requests with status (success, error, pending)\n- Filter by date range (today, last 7 days, custom range)\n- See full request/response data for debugging\n- **Retry failed requests** with one click\n- **Export logs** to CSV or JSON\n\n### Global Settings\nConfigure plugin-wide settings at **Settings → Silver Assist → CF7 to API**:\n\n| Setting | Description | Default |\n|---------|-------------|----------|\n| Max Retries per Entry | Maximum retry attempts for a single request | 3 |\n| Max Retries per Hour | Global hourly rate limit for retries | 10 |\n| Sensitive Patterns | Field patterns to anonymize (password, token, etc.) | Built-in list |\n| Enable Logging | Turn API logging on/off | Enabled |\n| Log Retention | Auto-delete logs older than X days | 30 days |\n\n---\n\n## 💡 Real-World Examples\n\n### Example 1: Send Leads to Your CRM\n```\nForm Fields → API Parameters\n-----------------------------\n[your-name]    → customer_name\n[your-email]   → email_address\n[your-phone]   → phone_number\n[your-message] → inquiry_details\n```\n\n### Example 2: Add Email Subscribers\n```\nAPI Endpoint: https://api.mailchimp.com/3.0/lists/{list-id}/members\nMethod: POST\nHeaders: Authorization: apikey your-api-key\n\nField Mapping:\n[your-email] → email_address\n[your-name]  → merge_fields.FNAME\n```\n\n### Example 3: Slack Notifications\n```\nAPI Endpoint: https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK\nMethod: POST\n\nField Mapping:\nStatic: \"New contact form submission\" → text\n[your-name] → attachments.fields.title\n[your-message] → attachments.fields.value\n```\n\n---\n\n## 🛠️ Supported Integrations\n\n### 📈 **CRM Systems**\n- Salesforce\n- HubSpot\n- Pipedrive\n- Zoho CRM\n- Custom CRM APIs\n\n### 📧 **Email Marketing**\n- Mailchimp\n- ConvertKit\n- ActiveCampaign\n- Constant Contact\n- AWeber\n\n### 💬 **Communication Tools**\n- Slack\n- Discord\n- Microsoft Teams\n- Custom webhooks\n\n### 🔗 **Automation Platforms**\n- Zapier\n- Integromat/Make\n- IFTTT\n- Custom applications\n\n---\n\n## 📋 Requirements\n\n- **WordPress**: 6.5 or higher\n- **PHP**: 8.2 or higher\n- **Contact Form 7**: Latest version\n- **SSL/HTTPS**: Recommended for secure API communications\n\n---\n\n## ⚙️ Installation\n\n### Via WordPress Admin (Recommended)\n1. Go to **Plugins → Add New** in your WordPress admin\n2. Search for **\"CF7 to API\"**\n3. Click **Install Now** → **Activate**\n\n### Manual Installation\n1. Download the plugin ZIP file\n2. Go to **Plugins → Add New → Upload Plugin**\n3. Choose the ZIP file and click **Install Now**\n4. **Activate** the plugin\n---\n\n## 📚 How to Configure\n\n### Step-by-Step Configuration Guide\n\n#### 1. **Access Form Settings**\n- Go to **Contact → Contact Forms** in WordPress admin\n- **Edit** the form you want to connect to an API\n- Click on the **\"API Integration\"** tab\n\n#### 2. **Basic API Settings**\n```\n✅ API Endpoint URL: https://your-api.com/endpoint\n✅ HTTP Method: POST (most common)\n✅ Data Format: JSON (recommended)\n```\n\n#### 3. **Add Authentication**\n**For Bearer Token:**\n```\nHeader Name: Authorization\nHeader Value: Bearer your-token-here\n```\n\n**For API Key:**\n```\nHeader Name: X-API-Key\nHeader Value: your-api-key-here\n```\n\n#### 4. **Map Your Fields**\n| Contact Form Field | API Parameter | Example |\n|-------------------|---------------|---------|\n| `[your-name]` | `name` | John Doe |\n| `[your-email]` | `email` | john@example.com |\n| `[your-phone]` | `phone` | +1234567890 |\n| `[your-message]` | `message` | Hello world! |\n\n#### 5. **Test Your Setup**\n1. **Use the \"Test Connection\" button**\n2. **Fill out and submit your form**\n3. **Check the debug logs** if something doesn't work\n4. **Verify data reaches your API**\n\n---\n\n## 🔧 Common Use Cases\n\n### 🏢 **CRM Integration**\n**Connect leads directly to your CRM system**\n\n**Popular CRMs:**\n- **Salesforce**: Use REST API with OAuth authentication\n- **HubSpot**: Simple API key authentication  \n- **Pipedrive**: REST API with personal token\n- **Zoho CRM**: OAuth 2.0 integration\n\n**Typical Setup:**\n```\nEndpoint: https://api.hubspot.com/contacts/v1/contact\nMethod: POST\nAuth: X-API-KEY header\n```\n\n### 📧 **Email Marketing**\n**Add subscribers automatically**\n\n**Popular Services:**\n- **Mailchimp**: Add to audience lists\n- **ConvertKit**: Create subscribers and add tags\n- **ActiveCampaign**: Add contacts and trigger automations\n\n**Typical Setup:**\n```\nEndpoint: https://your-account.api.mailchimp.com/3.0/lists/{list-id}/members  \nMethod: POST\nAuth: Authorization: apikey your-key\n```\n\n### 💬 **Notifications**\n**Get instant alerts about new submissions**\n\n**Popular Services:**\n- **Slack**: Webhook notifications to channels\n- **Discord**: Bot messages to servers  \n- **Microsoft Teams**: Connector webhooks\n\n**Typical Setup:**\n```\nEndpoint: https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK\nMethod: POST  \nFormat: JSON with text and attachments\n```\n\n---\n\n## �️ Troubleshooting\n\n### ❌ **Common Problems**\n\n#### **\"API Connection Failed\"**\n- ✅ Check your API endpoint URL (copy-paste from API docs)\n- ✅ Verify your API credentials are correct\n- ✅ Make sure your server can reach the external API\n- ✅ Check if the API requires specific headers\n\n#### **\"Data Not Appearing in API\"**\n- ✅ Verify field mapping (form field names must match exactly)\n- ✅ Check data format (JSON vs form parameters)\n- ✅ Review API documentation for required fields\n- ✅ Enable debug mode to see what's being sent\n\n#### **\"Form Submission Slow\"**\n- ✅ Reduce API timeout settings\n- ✅ Check if API server is responding slowly\n- ✅ Consider using asynchronous processing\n- ✅ Monitor API response times\n\n### 🔍 **Debug Mode**\nEnable detailed logging to troubleshoot issues:\n\n1. **Go to the API Integration tab**\n2. **Enable \"Debug Mode\"**\n3. **Submit a test form**\n4. **Review the debug log** for detailed information\n\n### 📞 **Getting Help**\n\n**Before asking for help:**\n- ✅ Check this README file\n- ✅ Review API documentation\n- ✅ Test with debug mode enabled\n- ✅ Try with a simple test API first\n\n**Where to get help:**\n- 🐛 [Report Bugs on GitHub](https://github.com/SilverAssist/contact-form-to-api/issues)\n\n---\n\n## 🎯 Pro Tips\n\n### ✨ **Best Practices**\n- **Test First**: Always test with a sample API before going live\n- **Use HTTPS**: Secure API endpoints protect sensitive data\n- **Monitor Logs**: Regularly check for failed submissions\n- **Backup Settings**: Export your configuration before making changes\n\n### 🚀 **Advanced Tips**\n- **Multiple APIs**: Send the same form to multiple services\n- **Conditional Logic**: Send to different APIs based on form values\n- **Custom Fields**: Map static values and computed fields\n- **Error Handling**: Set up fallback actions for failed API calls\n\n---\n\n## � **What's Next?**\n\nAfter setting up your first integration:\n\n1. **📊 Monitor Performance**: Check success rates and response times\n2. **🔄 Add More Integrations**: Connect to additional services\n3. **⚙️ Optimize Settings**: Fine-tune timeouts and retry logic\n4. **📱 Test Mobile**: Ensure forms work on all devices\n5. **🔒 Review Security**: Verify API credentials are secure\n\n---\n\n## 🏆 **Why Choose This Plugin?**\n\n### ✅ **User-Friendly**\n- No coding required\n- Visual configuration interface\n- Built-in testing tools\n- Clear documentation\n\n### ✅ **Reliable**\n- Automatic retries on failures\n- Comprehensive error logging\n- Performance monitoring\n- Secure data handling\n\n### ✅ **Flexible**\n- Works with any API\n- Multiple data formats\n- Custom authentication methods\n- Conditional processing\n\n### ✅ **Supported**\n- Regular updates\n- Community support\n- Detailed documentation\n- Open source\n\n---\n\n## ™️ Trademark Notice \u0026 Compliance\n\n### About Contact Form 7 Trademark\n\n**\"Contact Form 7\"** is a registered trademark of **Rock Lobster, LLC.**, the company behind the development of the Contact Form 7 WordPress plugin.\n\n### Our Compliance\n\nThis plugin (**CF7 to API**) is an **independent extension** that adds API integration functionality to Contact Form 7. We comply with the [Contact Form 7 trademark policy](https://contactform7.com/trademark-policy/) as follows:\n\n✅ **Plugin Name**: We use \"CF7\" (an unofficial abbreviated form permitted by the policy) instead of \"Contact Form 7\" in our plugin name\n✅ **No Affiliation**: We clearly state that this plugin is not affiliated with, endorsed by, or sponsored by Contact Form 7 or Rock Lobster, LLC\n✅ **Documentation**: We mention \"Contact Form 7\" only for reference and compatibility information\n✅ **No Confusion**: We avoid any suggestion of official endorsement or partnership\n\n### Our Relationship with Contact Form 7\n\n- **What we are**: An independent extension plugin that enhances Contact Form 7 with API connectivity features\n- **What we are NOT**: An official Contact Form 7 product, affiliate, or endorsed extension\n- **Our purpose**: To provide additional functionality to Contact Form 7 users who need API integrations\n\n### Acknowledgment\n\nWe are grateful to Rock Lobster, LLC and the Contact Form 7 development team for creating and maintaining the excellent Contact Form 7 plugin that makes this extension possible.\n\nIf you use Contact Form 7, please consider [supporting its development](https://contactform7.com/donate/).\n\n---\n\n## 📄 License Notice\n\nThis project is licensed under the **Polyform Noncommercial License 1.0.0**.\n\nYou are free to **use, modify, and share** this code **for noncommercial purposes only**.  \nCommercial use of any kind is **not permitted** without explicit permission from the author.  \n\nSee the [LICENSE](LICENSE) file for the full license text.\n\n---\n\n**Made with ❤️ by [Silver Assist](https://silverassist.com)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsilverassist%2Fcontact-form-to-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsilverassist%2Fcontact-form-to-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsilverassist%2Fcontact-form-to-api/lists"}