Firefish
Open-Source Firefish Connector
Firefish
The Firefish connector enables easy and secure data synchronization between your application and your customers’ Firefish accounts through unified data models.
Authorization
The Firefish connector uses OAuth for secure authentication. When creating a connection, the required OAuth scopes are automatically configured based on your specific operations needs (e.g. genericContact::create
, genericUser::list
).
✓ Automatic token refresh handling
✓ Proactive insufficient permissions detection
View our step-by-step integration guide
Whitelabel
Supported
You can choose to provide your own set of clientId
and clientSecret
for this
connector from the Morph Cloud dashboard; allowing a fully whitelabled experience
for your end-customers.
import { Morph } from "@runmorph/cloud";
const morph = Morph({ publicKey: "pk_demo_xxxxxxxxxxxxxxx", secretKey: "sk_demo_xxxxxxxxxxxxxxx"});
// create a new connection
const connection = morph.connections({ connectorId: "firefish", ownerId: "demo" });
await connection.create({ operations:[ "genericContact::list" ]});
// auhtorize the connection
const { auhtorizationUrl } = await connection.authorize();
// redirect the user to the auhtorizationUrl
Live Demo
Select a connector below to experience our seamless authentication flow and see
how easy it is to connect third-party services.
Models
Generic
The Firefish connector seamlessly integrates with our unified genericContact
model, enabling you to manage Contacts with rich data including firstName
, lastName
, phoneNumber
, email
and other key details
API Reference
GET | /resources/genericContact | List and Search Firefish Contacts |
GET | /resources/genericContact/:id | Retrieve a Firefish Contact |
POST | /resources/genericContact | Create a Firefish Contact |
PATCH | /resources/genericContact/:id | Update a Firefish Contact |
DEL | /resources/genericContact/:id | Delete a Firefish Contact |
Custom Fields
Supported
The Firefish connector supports our Field Mapping
feature, enabling you or your customers to seamlessly map Firefish Contact custom fields to the unified contact model. This allows for flexible data synchronization while maintaining data consistency across all connectors.
The Firefish connector seamlessly integrates with our unified genericCompany
model, enabling you to manage Companies with rich data including name
and other key details
API Reference
GET | /resources/genericCompany | List and Search Firefish Companies |
GET | /resources/genericCompany/:id | Retrieve a Firefish Company |
POST | /resources/genericCompany | Create a Firefish Company |
PATCH | /resources/genericCompany/:id | Update a Firefish Company |
DEL | /resources/genericCompany/:id | Delete a Firefish Company |
Custom Fields
Supported
The Firefish connector supports our Field Mapping
feature, enabling you or your customers to seamlessly map Firefish Company custom fields to the unified company model. This allows for flexible data synchronization while maintaining data consistency across all connectors.
The Firefish connector seamlessly integrates with our unified genericUser
model, enabling you to manage Users with rich data including firstName
, lastName
, email
and other key details
API Reference
GET | /resources/genericUser | List and Search Firefish Users |
GET | /resources/genericUser/:id | Retrieve a Firefish User |
POST | /resources/genericUser | Create a Firefish User |
PATCH | /resources/genericUser/:id | Update a Firefish User |
DEL | /resources/genericUser/:id | Delete a Firefish User |
Custom Fields
Supported
The Firefish connector supports our Field Mapping
feature, enabling you or your customers to seamlessly map Firefish User custom fields to the unified user model. This allows for flexible data synchronization while maintaining data consistency across all connectors.
The Firefish connector seamlessly integrates with our unified genericWorkspace
model, enabling you to manage Workspaces with rich data including name
and other key details
API Reference
GET | /resources/genericWorkspace | List and Search Firefish Workspaces |
GET | /resources/genericWorkspace/:id | Retrieve a Firefish Workspace |
POST | /resources/genericWorkspace | Create a Firefish Workspace |
PATCH | /resources/genericWorkspace/:id | Update a Firefish Workspace |
DEL | /resources/genericWorkspace/:id | Delete a Firefish Workspace |
Custom Fields
Supported
The Firefish connector supports our Field Mapping
feature, enabling you or your customers to seamlessly map Firefish Workspace custom fields to the unified workspace model. This allows for flexible data synchronization while maintaining data consistency across all connectors.
CRM
The Firefish connector seamlessly integrates with our unified crmOpportunity
model, enabling you to manage Opportunities with rich data including name
, amount
, currency
, pipeline
, stage
and other key details
API Reference
GET | /resources/crmOpportunity | List and Search Firefish Opportunities |
GET | /resources/crmOpportunity/:id | Retrieve a Firefish Opportunity |
POST | /resources/crmOpportunity | Create a Firefish Opportunity |
PATCH | /resources/crmOpportunity/:id | Update a Firefish Opportunity |
DEL | /resources/crmOpportunity/:id | Delete a Firefish Opportunity |
Custom Fields
Supported
The Firefish connector supports our Field Mapping
feature, enabling you or your customers to seamlessly map Firefish Opportunity custom fields to the unified opportunity model. This allows for flexible data synchronization while maintaining data consistency across all connectors.
The Firefish connector seamlessly integrates with our unified crmPipeline
model, enabling you to manage Pipelines with rich data including name
, stages
and other key details
API Reference
GET | /resources/crmPipeline | List and Search Firefish Pipelines |
GET | /resources/crmPipeline/:id | Retrieve a Firefish Pipeline |
POST | /resources/crmPipeline | Create a Firefish Pipeline |
PATCH | /resources/crmPipeline/:id | Update a Firefish Pipeline |
DEL | /resources/crmPipeline/:id | Delete a Firefish Pipeline |
The Firefish connector seamlessly integrates with our unified crmStage
model, enabling you to manage Stages with rich data including pipeline
, name
, type
and other key details
API Reference
GET | /resources/crmStage | List and Search Firefish Stages |
GET | /resources/crmStage/:id | Retrieve a Firefish Stage |
POST | /resources/crmStage | Create a Firefish Stage |
PATCH | /resources/crmStage/:id | Update a Firefish Stage |
DEL | /resources/crmStage/:id | Delete a Firefish Stage |
The Firefish connector seamlessly integrates with our unified crmEngagement
model, enabling you to manage Engagements with rich data including type
, direction
, status
, title
, description
and other key details
API Reference
GET | /resources/crmEngagement | List and Search Firefish Engagements |
GET | /resources/crmEngagement/:id | Retrieve a Firefish Engagement |
POST | /resources/crmEngagement | Create a Firefish Engagement |
PATCH | /resources/crmEngagement/:id | Update a Firefish Engagement |
DEL | /resources/crmEngagement/:id | Delete a Firefish Engagement |
Custom Fields
Supported
The Firefish connector supports our Field Mapping
feature, enabling you or your customers to seamlessly map Firefish Engagement custom fields to the unified engagement model. This allows for flexible data synchronization while maintaining data consistency across all connectors.
Custom
Supported
Can’t find the unified model you need? The Firefish connector supports your own custom model.
Webhooks
The Firefish connector supports real-time event subscriptions, allowing you to receive instant notifications when records are created, updated, or deleted. Below are the supported models and their corresponding triggers.
Models | Created | Updated | Deleted | API Reference |
---|---|---|---|---|
genericContact | ||||
genericCompany | ||||
genericUser | ||||
genericWorkspace | ||||
crmOpportunity | ||||
crmPipeline | ||||
crmStage | ||||
crmEngagement |
Proxy
Supported
The Firefish connector supports our Proxy Request
feature, allowing you to directly
call any endpoints from Firefish’s public API without needing to handle authentication.
Your customer’s token will be automatically set and refreshed as needed, enabling
quick implementation of custom connector behaviors. View API Reference.