Back

WebinarJam API Essential Guide

Aug 13, 20246 minute read

What type of API does WebinarJam provide?

Based on the search results provided, it does not appear that WebinarJam specifically uses REST, GraphQL, or SOAP for its API. The search results do not contain definitive information about WebinarJam's API type. However, I can provide some general information about WebinarJam's API based on the available details:

Key Points:

  1. WebinarJam offers an API that requires approval and an API key to access.

  2. The API has separate endpoints for WebinarJam and EverWebinar:

    • WebinarJam API endpoint: https://api.webinarjam.com/webinarjam
    • EverWebinar API endpoint: https://api.webinarjam.com/everwebinar
  3. Connections to the API server must be secured with SSL.

  4. The API has rate limits of 20 API calls per second per user.

  5. The API allows for operations like retrieving webinar lists, getting webinar details, and registering people for webinars.

API Type

While the specific API type is not explicitly stated, based on the information provided, it appears that WebinarJam's API is likely a custom HTTP-based API. It doesn't seem to follow the exact conventions of REST, GraphQL, or SOAP based on the limited information available.

Best Practices

When using the WebinarJam API:

  1. Implement proper authentication using the provided API key.
  2. Use SSL for all connections to ensure security.
  3. Implement rate limiting in your code to avoid exceeding the 20 calls per second limit.
  4. Handle potential errors, including the 429 "Too many requests" error.
  5. Ensure compliance with data privacy regulations when handling user data through the API.

To get definitive information about the specific API type and more detailed documentation, it would be best to contact WebinarJam's support directly or check their official API documentation if available.

Does the WebinarJam API have webhooks?

Based on the information provided, it does not appear that the official WebinarJam API offers webhooks or event subscriptions. The key points are:

  1. The WebinarJam API allows you to perform actions like retrieving webinar details and registering attendees, but does not mention any webhook functionality.

  2. The API documentation describes how to make API calls to WebinarJam's endpoints, but does not list any webhook events you can subscribe to.

  3. To register attendees, you need to make a POST request to the WebinarJam API with the required attendee information. This is an active API call, not a webhook subscription.

  4. The question in the community forum is about using Zapier to connect TicketSpice to WebinarJam via the API, not through webhooks.

  5. The API has rate limits and requires you to obtain API keys and webinar IDs through API calls, which is typical for REST APIs but not for webhook systems.

Key points to consider:

  • WebinarJam offers a REST API for integrations, not a webhook system.
  • You can use the API to programmatically register attendees and retrieve webinar information.
  • To integrate with other systems, you would need to make active API calls rather than receiving webhook events.

Best practices:

  • When integrating with WebinarJam, use their official API documentation as the primary reference.
  • Implement proper error handling and respect the API rate limits when making calls.
  • Consider using a queueing system if you need to register many attendees to avoid hitting rate limits.

In summary, while WebinarJam offers API integration capabilities, it does not appear to provide a webhook system for event subscriptions based on the available information.

Rate Limits and other limitations

Based on the search results provided, here are the API Rate Limits for the WebinarJam API:

API Call Limits

The WebinarJam API has the following rate limits:

  1. A hardcoded limit of 20 API calls per second per user.
  2. If this limit is exceeded, the system will return a "Too many requests" error message (429 error).

Key Points to Consider

  • It is recommended to implement scripts in a queue system that throttles outbound API calls to a maximum rate of 20 calls per second.
  • If the rate limit is exceeded, wait a short period and try the call again.
  • A queue system can process calls in a first-in-first-out order without exceeding the limit, even during bursts of activity.

Best Practices

  1. Implement a queue system for API calls to avoid exceeding the rate limit.
  2. Handle 429 errors gracefully by implementing a retry mechanism with a delay.
  3. Monitor your API usage to ensure you stay within the limits.
  4. Consider spreading out API calls over time if possible, rather than making many calls at once.

Additional Information

  • Connections to the API server must be secured with SSL. Non-SSL connections will be dropped.
  • The WebinarJam API endpoint is: https://api.webinarjam.com/webinarjam.
  • Users are responsible for ensuring appropriate consent is collected from webinar registrants when using the API.

It's important to note that these rate limits are specific to the WebinarJam API. Other APIs mentioned in the search results (such as EverWebinar or Candid's Nonprofit Search API) have different rate limits and should not be confused with WebinarJam's limits.

Latest API Version

Based on the search results provided, I can answer your question about the most recent version of the WebinarJam API:

The most recent version of the WebinarJam API is not explicitly mentioned in the search results. However, the information provided indicates that the WebinarJam API is currently active and in use. Here are the key points to consider:

  1. The WebinarJam API endpoint is https://api.webinarjam.com/webinarjam.

  2. Connections to the API server must be secured with SSL. Non-SSL connections will be dropped.

  3. To use the WebinarJam API, you need to apply for an API key.

  4. The API allows you to perform various actions, such as:

    • Retrieving a full list of all webinars published in your account
    • Getting details about a particular webinar from your account
    • Registering a person to a specific webinar.
  5. The most recent release notes available are for WebinarJam 7.11.0, released on July 23, 2024. While this doesn't directly relate to the API version, it suggests that the platform is actively maintained and updated.

  6. When using the API, you need to ensure compliance with data privacy regulations and obtain appropriate consent from webinar registrants.

It's important to note that API versions are not always explicitly stated, and companies often maintain backward compatibility while incrementally updating their APIs. To get the most up-to-date information about the WebinarJam API version, it would be best to contact WebinarJam support directly or check their official developer documentation, which may not be included in these search results.

How to get a WebinarJam developer account and API Keys?

To get a developer account for WebinarJam and create an API integration, follow these steps:

  1. Apply for an API key:

    • Go to the WebinarJam support page and apply for an API key.
    • You'll need to provide:
      • The URL of your app or the third-party app using the API
      • Whether your app will subscribe users to webinars
      • Any additional notes about your app
  2. Wait for approval:

    • You should receive a response within two business days from submission.
  3. Once approved, find your API key:

    • Go to the main Webinars dashboard
    • Click the "Advanced" link above the module for any event
    • In the "Advanced integration" window, click "API custom integration" to find the API key
  4. Connect to the API:

    • Use the appropriate API endpoint:
      • WebinarJam API: https://api.webinarjam.com/webinarjam
      • EverWebinar API: https://api.webinarjam.com/everwebinar
    • Ensure connections are secured with SSL
  5. Implement data privacy requirements:

    • Ensure you have appropriate consent from webinar registrants for handling their personal data and future communications

Key points to consider:

  • The API key is global for your entire account, so you don't need a new key for each webinar.
  • Connections must be secured with SSL; non-SSL connections will be dropped.
  • Comply with data privacy regulations applicable to your location and your registrants' locations.

Best practices:

  • Store your API key securely and never share it publicly.
  • Implement proper error handling and rate limiting in your API requests.
  • Keep your integration up-to-date with any changes or updates to the WebinarJam API.

What can you do with the WebinarJam API?

Based on the search results provided, here is a list of data models you can interact with using the WebinarJam API, along with what is possible for each:

Webinars

  • Retrieve a full list of all webinars published in your account
  • Get details about one particular webinar from your account
  • Register a person to a specific webinar

Participants

  • Register a person to a specific webinar
  • Collect personal data from webinar registrants (with appropriate consent)

API Usage

  • Make API calls (limited to 20 calls per second per user)

Account Information

  • Use your API key to authenticate requests

Data Privacy

  • Handle personal data of webinar registrants (with appropriate consent)
  • Subscribe users to webinars (with permission)
  • Communicate with registrants in the future (with permission)

Key points to consider:

  • The API allows for basic webinar management tasks like listing webinars, getting webinar details, and registering participants.
  • There are strict data privacy requirements when handling participant data through the API.
  • API usage is rate-limited to 20 calls per second per user.
  • Authentication is done using an API key.
  • The API can be used to automate webinar management tasks and integrate with other systems.

It's important to note that while these are the main data models and interactions mentioned in the search results, the full extent of the API's capabilities may not be covered here. For the most up-to-date and comprehensive information, it's recommended to consult the official WebinarJam API documentation.