Skip to content

Pubmate Integration

PubCounter integrates with Pubmate.io to automate inventory submissions to JW Hub.

What is Pubmate?

Section titled “What is Pubmate?”

Pubmate is a third-party service that automates the submission of inventory data to JW Hub. Instead of manually entering counts on jw.org, Pubmate:

  1. Receives your inventory data from PubCounter
  2. Logs into JW Hub with your credentials
  3. Submits counts automatically
  4. Reports success or any issues

Prerequisites

Section titled “Prerequisites”

Before enabling Pubmate integration:

  1. Pubmate subscription - Active subscription with Pubmate.io
  2. Super admin access - Only super admins can configure integrations
  3. JW Hub credentials - You’ll need valid jw.org login credentials

Enabling Pubmate

Section titled “Enabling Pubmate”

  1. Contact Pubmate.io

    Sign up for a Pubmate subscription and obtain your configuration details.

  2. Configure in PubCounter

    As a super admin:

    • Go to Kingdom Hall Settings → Integrations
    • Enable Pubmate integration
    • Enter your Pubmate URL
    • Save settings

  3. Verify Setup

    The Pubmate option will appear on the Reports page for authorized users.

Using Pubmate for Submissions

Section titled “Using Pubmate for Submissions”

Once configured, users with Pubmate access can submit directly from PubCounter:

  1. Generate your report

    Go to Reports and select the reporting period and languages.

  2. Click “Submit with Pubmate”

    A dialog will open for Pubmate submission.

  3. Enter JW Hub credentials

    Provide your jw.org username and password. These are sent securely to Pubmate and are not stored by PubCounter.

  4. Submit

    Pubmate processes your submission and reports results.

  5. Verify on JW Hub

    Log into jw.org to confirm your submission was recorded.

Security

Section titled “Security”

How Credentials Are Handled

Section titled “How Credentials Are Handled”
  1. You enter credentials in PubCounter’s dialog
  2. Credentials are sent directly to Pubmate’s servers over HTTPS
  3. PubCounter does not store your JW Hub credentials
  4. Pubmate uses credentials only for the submission session

API Key Protection

Section titled “API Key Protection”
  • Pubmate API keys are stored securely in PocketBase
  • Keys are never exposed to the frontend
  • Only server-side processes can retrieve API keys

Troubleshooting

Section titled “Troubleshooting”

”Pubmate not available”

Section titled “”Pubmate not available””
  • Check that your Kingdom Hall has Pubmate enabled
  • Verify your user profile has Pubmate subscription enabled
  • Contact your super admin

Submission failed

Section titled “Submission failed”
  • Verify your JW Hub credentials are correct
  • Check if JW Hub is accessible
  • Try again later—JW Hub may have maintenance
  • Contact Pubmate support if issues persist

Credentials rejected

Section titled “Credentials rejected”
  • Double-check username and password
  • Ensure you’re using your jw.org credentials
  • Try logging into jw.org directly to verify

Partial submission

Section titled “Partial submission”
  • Check the Pubmate response for details
  • Some publications may not be in JW Hub’s catalog
  • Manually submit any failed items on jw.org

Requirements

Section titled “Requirements”

User Requirements

Section titled “User Requirements”

To use Pubmate submissions:

  • Your user profile must have is_pubmate_subscribed enabled
  • Your Kingdom Hall must have Pubmate integration configured
  • You must have access to the languages you’re submitting

Technical Requirements

Section titled “Technical Requirements”
  • Active internet connection
  • Modern web browser
  • PubCounter account with appropriate permissions

Limitations

Section titled “Limitations”
  • Pubmate supports standard JW publication types
  • Custom or local publications may not be submittable
  • Submission times depend on JW Hub availability
  • Rate limits may apply for large submissions

Getting Help

Section titled “Getting Help”

For Pubmate-specific issues:

For PubCounter integration issues:

Next Steps

Section titled “Next Steps”