​
Integrations

This guide covers how to set up and manage integrations between Spicerack and other services, allowing you to extend functionality and streamline your workflow.

​
Integration Overview

Spicerack offers integrations with various services and platforms to:
  • Expand platform functionality
  • Synchronize data across systems
  • Automate workflows
  • Connect with external tools
  • Enhance communication channels

​
Available Integrations

​
Social Media

Connect with social platforms:
  • Discord: Event announcements, results posting, community management
  • Twitter/X: Automated event promotions and results sharing
  • Facebook: Event page management, community engagement
  • Instagram: Visual content sharing for events and products

​
Payment Processors

For handling transactions:
  • Stripe: Process payments for registrations and products
  • PayPal: Alternative payment processing
  • Square: In-person and online payments
  • Authorize.net: Additional payment processing options

​
Email Platforms

For enhanced communication:
  • Mailchimp: Advanced email marketing campaigns
  • SendGrid: Transactional and marketing emails
  • Gmail: Email integration for notifications
  • Outlook: Calendar and email synchronization

​
Game Publishers

For game-specific functionality:
  • Wizards of the Coast: Magic: The Gathering event reporting
  • Pokémon: Organized Play integration
  • Fantasy Flight Games: Organized Play reporting
  • Additional publishers: Various game-specific integrations

​
Analytics

For enhanced data insights:
  • Google Analytics: Website traffic and user behavior
  • Mixpanel: User engagement tracking
  • Amplitude: Product analytics
  • Hotjar: User experience insights

​
Setting Up Integrations

​
Accessing Integration Settings

  1. Navigate to Organization > Integrations
  2. Browse available integrations by category
  3. Select the integration you want to configure

​
Authorization Process

Most integrations follow this general setup process:
  1. Click Connect on your chosen integration
  2. You’ll be redirected to authenticate with the service
  3. Grant necessary permissions
  4. Create or select API credentials if required
  5. Return to Spicerack to complete configuration

​
Integration Configuration

​
Social Media Integrations

For platforms like Discord:
  1. Select Discord from the integrations page
  2. Click Connect
  3. Authorize the Spicerack app in Discord
  4. Configure settings:
    • Select server and channels
    • Choose notification types
    • Set up command permissions
    • Configure automated announcements
  5. Test the connection
  6. Save your settings

​
Payment Processor Integration

For platforms like Stripe:
  1. Select Stripe from the integrations page
  2. Click Connect
  3. Log in to your Stripe account or create a new one
  4. Authorize the connection
  5. Configure payment settings:
    • Transaction fees
    • Payout schedule
    • Refund policies
    • Receipt templates
  6. Test a transaction
  7. Activate the integration

​
Managing Integration Settings

​
Viewing Connected Services

  1. Navigate to Organization > Integrations > Connected
  2. View all active integrations
  3. Check connection status and health

​
Modifying Integration Settings

  1. Select an active integration from the list
  2. Click Edit Settings
  3. Update configuration options
  4. Save your changes

​
Disconnecting Integrations

To remove an integration:
  1. Find the integration in your connected services
  2. Click Disconnect
  3. Confirm your choice
  4. Manage any data retention options

​
Integration Webhooks

For advanced users and developers:
  1. Navigate to Organization > Integrations > Webhooks
  2. Click Create Webhook
  3. Configure:
    • Endpoint URL
    • Trigger events
    • Payload format
    • Security settings
  4. Test the webhook
  5. Activate and monitor performance

​
API Access

​
API Key Management

For custom integrations:
  1. Go to Organization > Integrations > API Keys
  2. Click Generate New Key
  3. Set permissions and access levels
  4. Name your key for reference
  5. Copy and securely store your API key
  6. Monitor key usage and performance

​
API Documentation

Access developer resources:
  1. Navigate to Organization > Integrations > API Docs
  2. Browse available endpoints
  3. View request/response formats
  4. Access code examples
  5. Review rate limits and usage guidelines

​
Integration Troubleshooting

​
Connection Issues

If an integration stops working:
  1. Go to Organization > Integrations > Connected
  2. Check the status indicator
  3. Click Test Connection
  4. View error messages or warnings
  5. Follow troubleshooting steps for specific issues
  6. Reconnect the integration if necessary

​
Activity Logs

Review integration activity:
  1. Navigate to Organization > Integrations > Logs
  2. View all integration-related events
  3. Filter by:
    • Integration type
    • Status (success/error)
    • Date range
    • Event type
  4. Export logs for additional analysis