/twenty-raycast-integration

Create records instantly across Standard and Custom Objects, Raycast Extension for @twentyhq

Primary LanguageTypeScript

As the codebase for this repository has been moved to the raycast repository and extension is published, this repository have been archived. Looking to contribute or have some feature suggestion ?

moved to https://github.com/raycast/extensions/tree/main/extensions/twenty

🔥 Twenty Raycast Integration

Twenty simplifies CRM management, empowering businesses to enhance productivity and drive growth. With this Raycast integration, record creation across standard and custom objects is now at your fingertips, making your workflow effortless and efficient. Experience how easy it is to use this Raycast for seamless record creation!

${\textcolor{#39FF14}{\textbf{🤝 Create records instantly across Standard and Custom Objects!}}}$

Command Descriptions

Create Object Record

With Create Object Record command, effortlessly create records in any standard or custom object. Search command press Enter to see active objects, then press CMD + Enter to unveil a form that fills in your record seamlessly into the CRM table — making CRM magic happen!


Getting Started

Get your API Keys from twenty developer settings , navigate to Raycast Command settings or try to access command which will open up view to provide your API key.

Twenty Api Token View

if you are selfhost user navigate to <self-host-url>/settings/developers, once you have your key, go to Raycast Command Settings to provide your selfhost api url and API key. If you don't provide selfhost url, Integration will assume https://api.twenty.com as your instance.

Raycast Settings

User Guide

To use the integration, search for the Create Object Record command, which will display all your active standard and custom objects currently in your twentyCRM. Its very flexible - if you create new objects or deactivate existing ones, this will automatically reflect those changes.

1.Twenty.mp4

When you deactivate any standard or custom object, it will no longer appear, ensuring you only see the information and objects you want to access. This makes the integration extensible and enhances your productivity.

2.Twenty.mp4

If you create new custom objects, they will appear, allowing you to quickly create your records instantly from Raycast.

3.Twenty.mp4

To create a record for any object, select your target object and press ENTER. This will open a form that matches the exact table schema you created in your CRM, following any validations it suggests to successfully create your record by pressing CMD + ENTER. Records cannot be created with an empty first column (such as Name, Title, etc.).

4.Twenty.mp4

Similar to creation of standard object record you can create custom objects record

5.Twenty.mp4

It's much more flexible—similar to objects, if you deactivate any fields, they will no longer appear in your object schema during record creation.

6.Twenty.mp4

No worries! If you add or update any fields in your standard objects, they will automatically appear in your object schema form in Raycast, looking closely you will see, if you add a select field with a default value provided some icon, it will display exactly what you’ve set when creation.

7.Twenty.mp4

🧑‍💻 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue. Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feat/AmazingFeature)
  3. Install Dependency (npm install) & follow getting started guide for api key.
  4. Commit your Changes (git commit -m 'feat: adds some amazing feature')
  5. Push to the Branch (git push origin feat/AmazingFeature)
  6. Open a Pull Request

💬 Connect With Me

Name Nabhag Motivaras
Twitter @NabhagMotivaras

Support my work

If you love my work and would like to support me, consider becoming a GitHub sponsor

Roadmap

  • Currently we support FULL_NAME, TEXT, LINKS, EMAILS, SELECT.
  • Supporting other fields are easy as we have build the foundation and its quite similar to what we have already build.
  • PHONE_NUMBER, CURRENCY similar to LINKS
  • RATING (1, 2, 3, 4, 5 as option), BOOLEAN (True or False as option), MULTI_SELECT are similar to SELECT
  • RELATION Similar to SELECT but requires additional work but doable
  • support seeing records of all objects