Partilhar via

Entegrations.io (Preview)

  • Reference

Entegrations.io, inc provides 3 broad set of features. 1) PayPal Invoicing, Payouts and IPN features leveraging your PayPal account. 2) Webhooks for Invoicing and Contacts leveraging your Xero account. 3) QBO Inovice leveraging your QuickBooks Online account.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name entegrations.io inc support
URL https://www.entegrations.io/#contact
Email support@entegrations.io
Connector Metadata
Publisher entegrations.io inc
Website https://www.entegrations.io
Privacy policy https://www.entegrations.io/privacy.html
Categories Productivity

Entegrations.io provides Invoicing, Payouts and IPN data that leverages your PayPal account. The Invoicing feature allows creating and sending invoices to a receiver via PayPal platform. Payouts feature allows sending Payouts to one or more receivers via PayPal platform. IPN feature allows receiving PayPal IPN data. All these 3 features work by proxying thru a third-party i.e. entegrations.io. You would need credentials before you could use this connector. For this, you would need to go thru a one-time PayPal authorization and to allow us to create Invoices or Payouts on your behalf. Visit https://portal.entegrations.io/portal for on-boarding instructions. As part of the on-boarding, you would get API Key that you could use for the connection while using custom connector on Microsoft Flow.

Prerequisites

Subscribing to one of the plans available at https://portal.entegrations.io/portal is a prerequisite to use this connector. To start with, you can chose a basic plan. As part of subscription and enabling this connector there, you would get an API key to be used.

How to get credentials

  1. Sign-up to a suitable plan at https://portal.entegrations.io/portal
  2. Sign-in to go the "My Account" page.
  3. Find this connector under "Available connectors/apps" section. Enable the connector and follow the one-time auth flow.
  4. Access and copy the auto-generated API key and use it in your flow while using this connector.

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Advanced Use: Delete the invoicing, payouts etc webhook

Advanced Use: Deletes the Entegrations.io webhook that corresponds to the PayPal webhook.
Create a PayPal Invoice

Create a draft PayPal Invoice and immediately sends it to a receiver as per their APIs https://developer.paypal.com/docs/api/invoicing/v1/#invoices_create and https://developer.paypal.com/docs/api/invoicing/v1/#invoices_send
Create a QBO Invoice

Create and sends and a QuickBooks Online Invoice as per their API https://developer.intuit.com/app/developer/qbo/docs/api/accounting/ecommerce/invoice
Create PayPal Payouts

Create PayPal Payouts to one or more receivers as per their API https://developer.paypal.com/docs/api/payments.payouts-batch/v1/#payouts_create
Delete the Contacts webhook

Deletes the Entegrations.io webhook that corresponds to the Xero Contacts updates webhook.
Delete the generic IPN webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's generic webhook.
Delete the invoice paid webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal Invoice paid webhook.
Delete the Invoices webhook

Deletes the Entegrations.io webhook that corresponds to the Xero Invoices webhook.
Delete the IPN's express_checkout completed webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's express_checkout completed webhook.
Delete the IPN's new_case created webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's new_case created webhook.
Delete the IPN's recurring_payment completed webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's recurring_payment completed webhook.
Delete the payouts success webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal Payouts success webhook.

Advanced Use: Delete the invoicing, payouts etc webhook

Operation ID:
EntegrationsWebhook4PayPalDeleteTrigger

Advanced Use: Deletes the Entegrations.io webhook that corresponds to the PayPal webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
 webhookId True string

ID of the Webhook being deleted

Create a PayPal Invoice

Operation ID:
CreateAndSendPayPalInvoice

Create a draft PayPal Invoice and immediately sends it to a receiver as per their APIs https://developer.paypal.com/docs/api/invoicing/v1/#invoices_create and https://developer.paypal.com/docs/api/invoicing/v1/#invoices_send

Parameters

Name Key Required Type Description
Sender's email
 email True string

Sender's email which corresponds to PayPal account.
Sender's first name
 first_name string

Sender's first name.
Sender's last name
 last_name string

Sender's last name.
Sender's business name
 business_name string

Sender's business name.
Sender's country code of phone
 country_code string

Country code of the phone.
Sender's phone number with area code
 national_number string

Phone nuber with area code.
Sender's Address 1
 line1 True string

Line 1 of address.
Sender's City
 city True string

City
Sender's State
 state string

State
Sender's Postal Code
 postal_code string

Postal Code
Sender's Country Code
 country_code True string

Two character ISO country code.
Bill to email
 email True string

Bill to email. This may be an email of reciever's PayPal account.
Billing First name
 first_name string

First name
Billing Last name
 last_name string

Last name
Shipping First name
 first_name string

First name
Shipping Last name
 last_name string

Last name
Shipping Address 1
 line1 string

Line 1 of address.
Shipping City
 city string

City
Shipping State
 state string

State
Shipping Postal code
 postal_code string

Postal code
Shipping Country code
 country_code string

Country code
Item name
 name string

Item name
Item Quantity
 quantity string

Quantity. For e.g. 1.5
Unit Price Currency
 currency True string

Currency
Unit Price Value
 value True string

Value
Item Tax type/name
 name True string

Tax type/name
Item Tax Percent
 percent True string

Percent. For e.g. 8.5
Discount percent
 percent string

Percent
Shipping Cost Currency
 currency string

Currency
Shipping Cost Value
 value string

Value
Invoice note
 note string

Invoice note
Invoice terms
 terms string

Invoice terms

Returns

Response details including status.

Body
EntegrationsInvoice4PayPalCreateResponse

Create a QBO Invoice

Operation ID:
CreateAndSendQuickBooksInvoice

Create and sends and a QuickBooks Online Invoice as per their API https://developer.intuit.com/app/developer/qbo/docs/api/accounting/ecommerce/invoice

Parameters

Name Key Required Type Description
Sender's email
 SenderEmail True string

Sender's email which corresponds to Intuit QuickBooks Online account.
Sender's Realm ID or Company ID
 RealmId True string

Sender's Realm ID or Company ID which corresponds to Intuit QuickBooks Online account.
Transaction Date
 TxnDate string

Transaction Date in YYYY-MM-DD format
Due Date
 DueDate string

Due Date in YYYY-MM-DD format
DocNumber
 DocNumber string

DocNumber
Amount
 Amount True double

Amount
Detail Type
 DetailType True string

Detail Type
Value
 value True string

Value
Name
 name True string

Name
Customer Ref
 value True string

Customer Ref

Returns

Response details including status.

Body
EntegrationsInvoice4IntuitCreateResponse

Create PayPal Payouts

Operation ID:
CreatePayouts

Create PayPal Payouts to one or more receivers as per their API https://developer.paypal.com/docs/api/payments.payouts-batch/v1/#payouts_create

Parameters

Name Key Required Type Description
Sender's email
 email True string

Sender's email which corresponds to PayPal account.
Sender's Batch ID
 sender_batch_id string

Sender's Batch ID (Should be unique value, in last 30 days, per PayPal).
Email Subject
 email_subject string

Subject of the email notification that would be sent out by PayPal.
Receiver Type
 recipient_type string

Recipient type. Valid values are either of EMAIL / PAYER_ID / PHONE. Either this value or the ones in Payout item/details is mandatory.
Receiver Type
 recipient_type string

Recipient type. Valid values are either of EMAIL / PAYER_ID / PHONE. Either this value or the one in Payout batch header is mandatory.
Receiver (email / payer id / phone)
 receiver True string

Receiver's email / PayPal payer_id / phone number.
Note
 note string

Payout item level note.
Sender's Item ID
 sender_item_id string

Sender's Payout Item ID (Should be unique value, in last 30 days, per PayPal).
Currency
 currency True string

Currency
Value
 value True string

Value

Returns

Body
EntegrationsPayouts4PayPalCreateResponse

Delete the Contacts webhook

Operation ID:
EntegrationsWebhook4XeroContactsDeleteTrigger

Deletes the Entegrations.io webhook that corresponds to the Xero Contacts updates webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
 webhookId True string

ID of the Webhook being deleted

Delete the generic IPN webhook

Operation ID:
EntegrationsWebhook4PayPalIpnDynamicDeleteTrigger

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's generic webhook.

Parameters

Name Key Required Type Description
txnType of the Webhook being deleted
 txnType True string

txnType of the Webhook being deleted
txnStatus of the Webhook being deleted
 txnStatus True string

txnStatus of the Webhook being deleted
ID of the Webhook being deleted
 webhookId True string

ID of the Webhook being deleted

Delete the invoice paid webhook

Operation ID:
EntegrationsWebhook4PayPalInvoiceDeleteTrigger

Deletes the Entegrations.io webhook that corresponds to the PayPal Invoice paid webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
 webhookId True string

ID of the Webhook being deleted

Delete the Invoices webhook

Operation ID:
EntegrationsWebhook4XeroInvoicesDeleteTrigger

Deletes the Entegrations.io webhook that corresponds to the Xero Invoices webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
 webhookId True string

ID of the Webhook being deleted

Delete the IPN's express_checkout completed webhook

Operation ID:
EntegrationsWebhook4PayPalIpnEcCompletedDeleteTrigger

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's express_checkout completed webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
 webhookId True string

ID of the Webhook being deleted

Delete the IPN's new_case created webhook

Operation ID:
EntegrationsWebhook4PayPalIpnNewCaseCreatedDeleteTrigger

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's new_case created webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
 webhookId True string

ID of the Webhook being deleted

Delete the IPN's recurring_payment completed webhook

Operation ID:
EntegrationsWebhook4PayPalIpnRecurringPaymentCompletedDeleteTrigger

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's recurring_payment completed webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
 webhookId True string

ID of the Webhook being deleted

Delete the payouts success webhook

Operation ID:
EntegrationsWebhook4PayPalPayoutsDeleteTrigger

Deletes the Entegrations.io webhook that corresponds to the PayPal Payouts success webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
 webhookId True string

ID of the Webhook being deleted

Triggers

Advanced Use: When an IPN (generic) update is received

Advanced Use: Creates an entegrations.io webhook for PayPal IPN event data and it triggers whenever entegrations.io receives an on-behalf-of IPN payload from PayPal. Note that this is default payload, getting you whatever PayPal sends out.
Advanced Use: When invoicing, payouts updates received

Advanced Use: Creates an entegrations.io webhook for PayPal Invoicing, Payouts etc webhooks data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload from PayPal. Note that this is default payload, getting you whatever PayPal sends out.
Whenever a Contact is created or updated at Xero

Creates an entegrations.io webhook for Xero Contacts data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Contacts from Xero.
Whenever an invoice (at PayPal) is paid

Creates an entegrations.io webhook for PayPal Invoicing Paid data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Invoice Paid from PayPal.
Whenever an Invoice is created or updated at Xero

Creates an entegrations.io webhook for Xero Invoices updates data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Invoices from Xero.
Whenever Express Checkout payment is completed

Creates an entegrations.io webhook for PayPal express_checkout completed IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.
Whenever New Case is created

Creates an entegrations.io webhook for PayPal new case created IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.
Whenever payouts is paid

Creates an entegrations.io webhook for PayPal Payouts Paid data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Payouts Paid from PayPal.
Whenever Recurring Payment is completed

Creates an entegrations.io webhook for PayPal recurring payment completed IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.

Advanced Use: When an IPN (generic) update is received

Operation ID:
EntegrationsWebhook4PayPalIpnDynamicCreateTrigger

Advanced Use: Creates an entegrations.io webhook for PayPal IPN event data and it triggers whenever entegrations.io receives an on-behalf-of IPN payload from PayPal. Note that this is default payload, getting you whatever PayPal sends out.

Parameters

Name Key Required Type Description
txn_type of the IPN being created.
 txnType True string

txn_type of the IPN being created. Leave all for all txn_types.
txn or payment status of the Webhook being created.
 txnStatus True string

txn or payment status of the Webhook being created. Leave all for all statuses.
paypalEmailAddress
 paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Body
EntegrationsWebhook4PayPalDefaultPushResponse

Advanced Use: When invoicing, payouts updates received

Operation ID:
EntegrationsWebhook4PayPalDefaultCreateTrigger

Advanced Use: Creates an entegrations.io webhook for PayPal Invoicing, Payouts etc webhooks data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload from PayPal. Note that this is default payload, getting you whatever PayPal sends out.

Parameters

Name Key Required Type Description
paypalEmailAddress
 paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Body
EntegrationsWebhook4PayPalDefaultPushResponse

Whenever a Contact is created or updated at Xero

Operation ID:
EntegrationsWebhook4XeroContactsCreateTrigger

Creates an entegrations.io webhook for Xero Contacts data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Contacts from Xero.

Parameters

Name Key Required Type Description
xeroEmailAddress
 xeroEmailAddress True string

Email address of the Xero account. You must use the same Xero email address you have used to onboard for the custom connector.

Returns

Body
EntegrationsWebhook4XeroContactsPushResponse

Whenever an invoice (at PayPal) is paid

Operation ID:
EntegrationsWebhook4PayPalInvoicingPaidCreateTrigger

Creates an entegrations.io webhook for PayPal Invoicing Paid data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Invoice Paid from PayPal.

Parameters

Name Key Required Type Description
paypalEmailAddress
 paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Body
EntegrationsWebhook4PayPalInvoicingPaidPushResponse

Whenever an Invoice is created or updated at Xero

Operation ID:
EntegrationsWebhook4XeroInvoicesCreateTrigger

Creates an entegrations.io webhook for Xero Invoices updates data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Invoices from Xero.

Parameters

Name Key Required Type Description
xeroEmailAddress
 xeroEmailAddress True string

Email address of the Xero account. You must use the same Xero email address you have used to onboard for the custom connector.
shouldGetInvoiceAsPdf
 shouldGetInvoiceAsPdf boolean

Indicate if invoice has also to be gotten as PDF from Xero in addition to invoice resource.

Returns

Body
EntegrationsWebhook4XeroInvoicesPushResponse

Whenever Express Checkout payment is completed

Operation ID:
EntegrationsWebhook4PayPalIpnEcCompletedCreateTrigger

Creates an entegrations.io webhook for PayPal express_checkout completed IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.

Parameters

Name Key Required Type Description
paypalEmailAddress
 paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Body
EntegrationsWebhook4PayPalIpnEcCompletedPushResponse

Whenever New Case is created

Operation ID:
EntegrationsWebhook4PayPalIpnNewCaseCreatedCreateTrigger

Creates an entegrations.io webhook for PayPal new case created IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.

Parameters

Name Key Required Type Description
paypalEmailAddress
 paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Body
EntegrationsWebhook4PayPalIpnNewCaseCreatedPushResponse

Whenever payouts is paid

Operation ID:
EntegrationsWebhook4PayPalPayoutsPaidCreateTrigger

Creates an entegrations.io webhook for PayPal Payouts Paid data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Payouts Paid from PayPal.

Parameters

Name Key Required Type Description
paypalEmailAddress
 paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Body
EntegrationsWebhook4PayPalPayoutsPaidPushResponse

Whenever Recurring Payment is completed

Operation ID:
EntegrationsWebhook4PayPalIpnRecurringPaymentCompletedCreateTrigger

Creates an entegrations.io webhook for PayPal recurring payment completed IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.

Parameters

Name Key Required Type Description
paypalEmailAddress
 paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Body
EntegrationsWebhook4PayPalIpnRecurringPaymentCompletedPushResponse

Definitions

EntegrationsInvoice4PayPalCreateResponse

Response details including status.

Name Path Type Description
status
 status string

Status of creating the Invoice. Possible values: success or error.
paypal_invoice_id
 details.paypal_invoice_id string

Invoice ID generated by PayPal.
paypal_invoice_number
 details.paypal_invoice_number string

Invoice Number generated by PayPal.
errorMessage
 errorMessage string

Error message, if there is any error.

EntegrationsPayouts4PayPalCreateResponse

Name Path Type Description
status
 status string

Status of creating the Payouts. Possible values: success or error.
paypal_payout_batch_id
 details.paypal_payout_batch_id string

Batch ID generated by the PayPal for this Payout.
sender_batch_id
 details.sender_batch_id string

Batch ID that was sent in the request (echoing back the same value)
errorMessage
 errorMessage string

Error message, if there is any error.

EntegrationsWebhook4PayPalDefaultPushResponse

Name Path Type Description
ID as given by PayPal
 id string
create_time as given by PayPal
 create_time string
event_type as given by PayPal
 event_type string
resource_type as given by PayPal
 resource_type string
summary as given by PayPal
 summary string
resource as given by PayPal
 resource object
Stringified version of the resource given by PayPal
 resource_json_stringified string

EntegrationsWebhook4PayPalInvoicingPaidPushResponse

Name Path Type Description
ID as given by PayPal
 invoice_paid_paypal_invoice_id string
create_time as given by PayPal
 invoice_paid_time string
summary as given by PayPal
 invoice_paid_summary string
resource as given by PayPal
 invoice_paid_resource object

EntegrationsWebhook4PayPalPayoutsPaidPushResponse

Name Path Type Description
ID as given by PayPal
 payouts_batch_success_paypal_payout_batch_id string
create_time as given by PayPal
 payouts_batch_success_time string
summary as given by PayPal
 payouts_batch_success_summary string
resource as given by PayPal
 payouts_batch_success_resource object

EntegrationsWebhook4PayPalIpnEcCompletedPushResponse

Name Path Type Description
txn_id as given by PayPal
 txn_id string
payment_date as given by PayPal
 payment_date string
mc_gross as given by PayPal
 mc_gross string
mc_fee as given by PayPal
 mc_fee string
payer_email as given by PayPal
 payer_email string

EntegrationsWebhook4PayPalIpnNewCaseCreatedPushResponse

Name Path Type Description
case_creation_date as given by PayPal
 case_creation_date string
case_id as given by PayPal
 case_id string
buyer_additional_information as given by PayPal
 buyer_additional_information string
case_type as given by PayPal
 case_type string
reason_code as given by PayPal
 reason_code string

EntegrationsWebhook4PayPalIpnRecurringPaymentCompletedPushResponse

Name Path Type Description
txn_id as given by PayPal
 txn_id string
payment_date as given by PayPal
 payment_date string
custom value (that you must have used during your integration with PayPal and that's) as given by PayPal
 custom string
payment_status as given by PayPal
 payment_status string
amount as given by PayPal
 amount string
first and last name, if they are null. Otherwise, the business name. These values are as given by PayPal
 payer_full_name string
payer_email as given by PayPal
 payer_email string

EntegrationsWebhook4XeroInvoicesPushResponse

Name Path Type Description
resourceUrl as given by Xero
 resource_url string
resourceId as given by Xero
 resource_id string
eventDateUtc as given by Xero, for e.g. 2017-06-21T01:15:39.902
 event_date_tc string
eventType as given by Xero. Can be Create or Update
 event_type string
eventCategory as given by Xero. Can be INVOICE or CONTACT, but INVOICE for this scenario.
 event_category string
tenantId as given by Xero, for e.g. c2cc9b6e-9458-4c7d-93cc-f02b81b0594f
 tenant_id string
tenantType as given by Xero, which is ORGANISATION for now
 tenantType string
Invoice resource as given by Xero.
 invoice_resource object
When fetching this invoice as PDF, this optional field can contain Base64 version of application/pdf content given by Xero.
 invoice_pdf_as_base64 object

EntegrationsWebhook4XeroContactsPushResponse

Name Path Type Description
resourceUrl as given by Xero
 resource_url string
resourceId as given by Xero
 resource_id string
eventDateUtc as given by Xero, for e.g. 2017-06-21T01:15:39.902
 event_date_tc string
eventType as given by Xero. Can be Create or Update
 event_type string
eventCategory as given by Xero. Can be INVOICE or CONTACT, but CONTACT for this scenario.
 event_category string
tenantId as given by Xero, for e.g. c2cc9b6e-9458-4c7d-93cc-f02b81b0594f
 tenant_id string
tenantType as given by Xero, which is ORGANISATION for now
 tenantType string
contact resource as given by Xero
 contact_resource object

EntegrationsInvoice4IntuitCreateResponse

Response details including status.

Name Path Type Description
status
 status string

Status of creating the Invoice. Possible values: success or error.
intuit_invoice_id
 details.intuit_invoice_id string

Invoice ID generated by QuickBooks.
intuit_invoice_number
 details.intuit_invoice_number string

Invoice Number generated by QuickBooks.
errorMessage
 errorMessage string

Error message, if there is any error.