<img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=1094218042721276&amp;ev=PageView&amp;noscript=1">
Skip to content

Customization Entry 16

What are CRM cards in HubSpot?

CRM cards are custom interfaces inside HubSpot that display record-specific information or let staff take action without leaving the record they are viewing. HubSpot now generally calls these integration-based experiences app cards. A well-designed app card can guide a nonprofit process, update CRM records, or securely exchange selected information with a connected system.

What can an app card help staff do?

Depending on its design and supported location, an app card can turn a CRM record into a practical workspace. Staff may be able to:

  • Review information from another system
  • Enter information through a guided form
  • Create or update HubSpot records
  • Create several related records at once
  • Apply associations and association labels
  • Start an internal or external process
  • Retrieve a status or result
  • Correct integration or data-quality issues

App cards can be supplied by a Marketplace app, a private app built for one organization, or an internal integration connecting HubSpot with another nonprofit system.

How is an app card different from an ordinary record card?

Standard HubSpot cards use functionality already available in the platform. These can include property lists, data highlights, association tables, reports, activity summaries, stage trackers, and quick actions.

An app card is supplied by an installed or custom-built application. It can collect input, validate that input, call an external service, coordinate changes across several records, and return a useful result to the user.

A standard association table might show a contact's memberships. An app card could guide a staff member through creating a membership, connecting it to the correct person and household, applying the right labels, and starting the renewal process.

Example: Create a membership

A supporter mails in a paper membership form. Instead of creating and connecting each record manually, staff open a guided card on the contact record.

  • Select membership type and level
  • Enter dates and payment details
  • Connect the contact and household
  • Add other covered members
  • Apply the required labels
  • Start the welcome process

Example: Request a background check

A volunteer coordinator can request a screening from the applicant's record, then see its operational status in HubSpot.

  • Confirm consent and required fields
  • Send only necessary information
  • Store the provider request ID
  • Show processing status
  • Receive an approved status update
  • Notify the appropriate team member

Three ways app cards can extend nonprofit operations

1. Extend HubSpot

Add a guided process that HubSpot does not provide in the exact form the nonprofit needs, such as creating a household membership, assigning a volunteer, or validating a complex record before submission.

2. Bring selected information into HubSpot

Display useful details from a connected platform, such as training completion, event check-in, accounting payment status, sponsorship benefits, or program eligibility.

3. Affect an outside system

Use approved HubSpot information to initiate an action elsewhere, such as requesting a background check, registering a volunteer for training, or starting an electronic-signature process.

A single card may combine all three functions. That does not mean the outside platform's complete interface is embedded in HubSpot. The exact experience depends on HubSpot's supported components and the provider's APIs, authentication, and security rules.

Important technical note

The card does not create the process by itself.

An app card is the staff-facing interface for a larger technical process. The complete solution may require a HubSpot app, UI extensions, APIs, serverless or external services, authentication, permissions, validation, duplicate prevention, workflows, error handling, logging, and monitoring.

The process also needs clear business rules. For a membership, the application must know which object to use, which fields are required, how households are identified, which labels to apply, how duplicate memberships are handled, and what should happen if only part of the process succeeds.

Design around a complete staff task

Start with the outcome a staff member should be able to complete from the record, not the amount of data that can fit on a card. A useful app card should make the following clear:

  • Why the card is present
  • What the current status means
  • What information is required
  • Which action is available
  • Whether the user has permission
  • What happens after submission
  • Whether another system is affected
  • What remains incomplete

Validation should happen before a consequential action. Error messages should explain the specific issue and the next step. If a multi-step process only partially succeeds, the card should show what completed, what failed, and whether staff can retry safely.

Protect sensitive information

Some app-card processes involve sensitive or regulated data. A background-check card does not mean a detailed screening report should be copied into HubSpot or shown to every user. The nonprofit should define:

  • What information may be collected
  • Whether consent is required
  • Who may request the action
  • Who may see the result or status
  • Which system stores the detailed record
  • How long information is retained
  • How access and actions are audited
  • Which legal and compliance rules apply

Exchange only the information required for the approved process. In many cases, HubSpot needs an operational status, not a complete external report.

Does every nonprofit process need an app card?

No. First determine whether a property list, association table, report card, record-creation form, workflow, playbook, quick action, existing connected-app card, or better record customization can solve the need.

Custom development is most valuable when it meaningfully simplifies a complex or cross-system process. An unnecessary card can add development cost, maintenance, security risk, slow record pages, and create another experience staff must learn.

Requirements and limitations

The exact experience depends on the nonprofit's HubSpot subscription, app type, card location, object and record layout, installed apps, developer resources, external APIs, authentication, permissions, data sensitivity, and ongoing support capacity.

Before promising an app card, confirm:

  • Whether an existing integration already offers one
  • Whether the desired action is available through APIs
  • Which records and associations must exist
  • Whether information should display, synchronize, or both
  • Whether users have the required permissions
  • Whether the needed HubSpot location is supported
  • How partial failures and duplicates are handled
  • Who owns monitoring, maintenance, and updates

HubSpot's app-card framework continues to evolve. Supported locations, components, app-object features, migration guidance, and developer limits should be verified during implementation.