PlumHelp
Help · Workspace settings

Custom objects

Keep kinds of record of your own, such as vendors, sites or projects, with the fields you choose, on your accounts, on your deals, or on their own list. No code needed.

Owners, admins and revops set them up. Anyone who can edit accounts adds and changes records; everyone else in the workspace can read them.

Open Objects in the workspace settings. An object is a kind of record, such as Vendors. Each vendor you add is a record of it, with a name and the fields you give the object.

Add an object

  1. Open Add object.
  2. Give it a Name of one, such as Vendor, and a Name of many, such as Vendors. Add a short description if it helps.
  3. Choose what each one belongs to: an account, a deal, or nothing.
  4. Select Add object.
  5. Open it and select Fields to give it fields, exactly as you do for accounts or deals.

Where records show

  • An object that belongs to an account gets a section of its own on every account page, listing that account's records with a form to add one. The same goes for deals.
  • Every object has its own list of all its records. Reach it from the section on an account or deal (All vendors), from Objects in the settings, or from the Accounts page.
  • A record's page shows its fields, its files and its history. Fields marked Show it on the list appear beside each record's name.
  • Export on an object's list downloads all its records as a spreadsheet, archived ones included, with a column for each field.

Rules that keep your data meaningful

  • What an object's records belong to can't be changed once the object is added. You can rename it at any time.
  • Objects and records are archived, never deleted. Archiving a record takes it off the lists; Restore brings it back.
  • Archiving an object hides it and its records everywhere. They are kept, unchanged, and come back when an owner, admin or revops member restores it.
  • Plum checks every value against the object's fields when a record is saved, whether it comes from a form or the API.
  • Every change to an object or a record is in the change history, with who made it. A record added to an account or a deal also shows in that account's or deal's history.

Through the API and an assistant

The API lists your objects at /api/v1/objects, each object's records at /api/v1/objects/<key>, and one record at /api/v1/objects/<key>/<id>, with any read key. An assistant connected over MCP can list objects, search records and read a record. Records are added and changed in Plum.

A workspace can have up to ten objects in use at a time, and keep up to fifty in all. Each object can hold up to ten thousand records, archived ones included. A record's name is up to 200 characters; an object's names are up to 40 characters each.

Related