# Problem with connector-spec.json

**URL:** <https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658>\
**Category:** SHF Discussion and Questions\
**Tags:** saas-connector\
**Created:** [February 28, 2023, 2:35pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658 "2023-02-28T14:35:43Z")\
**Posts on this page:** 16\
**Page:** 1

<div class="post-metadata">

**Author:** ![haydn-cahir-rio](https://avatars.discourse-cdn.com/v4/letter/h/b5a626/32.png) [@haydn-cahir-rio](https://developer.sailpoint.com/discuss/u/haydn-cahir-rio)\
**Post date:** [February 28, 2023, 2:35pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/1 "2023-02-28T14:35:43Z")

</div>

Hi,  
I am trying to create source config item with the type of “json” (as per [Connector Specification File | SailPoint Developer Community](https://developer.sailpoint.com/idn/docs/saas-connectivity/connector-spec)). When I run “npm run pack-zip” and use “sail conn upload” on the zip file I receive this error message:

```auto
Error: upload failed. status: 400 Bad Request
body: {"detailCode":"Bad Request","trackingId":"e2b3a4e177b14b85bb1b4648dab4893e","messages":[{"locale":"en-US","localeOrigin":"DEFAULT","text":"400 Bad Request: connector specification validation failed: Schema validation error in path: [/sourceConfig: [{\"items\":[{\"helpTex... did Not match any specified AnyOf schemas] (e2b3a4e177b14b85bb1b4648dab4893e)"}]}

```

I have confirmed it is the item with type=json:

```auto
{
	"key": "inclusionList",
	"type": "json",
	"label": "Inclusion List - JSON formatted array",
	"helpText": "The JSON formatted list to always include during aggregation",
	"required": false
}

```

Am I doing something wrong or is this a bug?  
Cheers

---

<div class="post-metadata">

**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\
**Post date:** [February 28, 2023, 6:46pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/2 "2023-02-28T18:46:29Z")

</div>

Can you share your connector spec file? Please omit any sensitive data if necessary.

---

<div class="post-metadata">

**Author:** ![haydn-cahir-rio](https://avatars.discourse-cdn.com/v4/letter/h/b5a626/32.png) [@haydn-cahir-rio](https://developer.sailpoint.com/discuss/u/haydn-cahir-rio)\
**Post date:** [March 1, 2023, 1:33am UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/3 "2023-03-01T01:33:48Z")

</div>

Sure can:

[connector-spec.txt](https://developer.sailpoint.com/discuss/uploads/short-url/hLQRBKiSaKS4w1x9xblajwM6pNU.txt) (9.1 KB)

There are two config items called “inclusionList” and “exclusionList” that are current set to “text” so that I can upload the connector zip file. They should be “json” if it worked.

---

<div class="post-metadata">

**Author:** ![philip-ellis](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/philip-ellis/32/502_2.png) [@philip-ellis](https://developer.sailpoint.com/discuss/u/philip-ellis)\
**Post date:** [March 1, 2023, 3:36pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/4 "2023-03-01T15:36:20Z")

</div>

After looking into the problem with our development team, it turns out json is not a supported type. I have created a PR to fix this in our docs: [Update connector-spec.md by philip-ellis-sp · Pull Request #186 · sailpoint-oss/developer.sailpoint.com · GitHub](https://github.com/sailpoint-oss/developer.sailpoint.com/pull/186)

---

<div class="post-metadata">

**Author:** ![haydn-cahir-rio](https://avatars.discourse-cdn.com/v4/letter/h/b5a626/32.png) [@haydn-cahir-rio](https://developer.sailpoint.com/discuss/u/haydn-cahir-rio)\
**Post date:** [March 1, 2023, 3:39pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/5 "2023-03-01T15:39:18Z")

</div>

Hi Philip,

Thanks for the update. I notice in the PR that you are also adding a “textarea” type. Is that currently supported by the SDK? I have a large block of JSON I want to pass in as a config value.

Cheers

---

<div class="post-metadata">

**Author:** ![philip-ellis](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/philip-ellis/32/502_2.png) [@philip-ellis](https://developer.sailpoint.com/discuss/u/philip-ellis)\
**Post date:** [March 2, 2023, 2:22pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/6 "2023-03-02T14:22:34Z")

</div>

Yes, textarea type should work. I have not personally tried them all but I was given an updated list by engineering. Let me know if you have any difficulty using the additional types.

---

<div class="post-metadata">

**Author:** ![haydn-cahir-rio](https://avatars.discourse-cdn.com/v4/letter/h/b5a626/32.png) [@haydn-cahir-rio](https://developer.sailpoint.com/discuss/u/haydn-cahir-rio)\
**Post date:** [March 2, 2023, 2:25pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/7 "2023-03-02T14:25:06Z")

</div>

Thanks Philip, trying it at the moment. It would be great to get some examples of each type in the documentation maybe, to show how to use each type? Thinking types like select, toggle, list, keyValue, cardList etc.

---

<div class="post-metadata">

**Author:** ![philip-ellis](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/philip-ellis/32/502_2.png) [@philip-ellis](https://developer.sailpoint.com/discuss/u/philip-ellis)\
**Post date:** [March 10, 2023, 4:11pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/8 "2023-03-10T16:11:48Z")

</div>

I just created an issue here:

> <https://github.com/sailpoint-oss/developer.sailpoint.com/issues/203>
>
> Need better documentation on field types in SaaS Connectivity
> 
> 
> Please add mo…re documentation on the different data types that can be used in https://developer.sailpoint.com/idn/docs/saas-connectivity/connector-spec#description-of-fields. It would be nice to have examples of each of the types:
> 
> type: The configuration items' types. The following types are valid:
> text
> number
> secret
> textarea
> secrettextarea
> checkbox
> url
> radio
> select
> toggle
> list
> keyValue
> cardList

Please note that the entire developer website is open source, so feel free to make edits to any of the documentation pages as you see areas to improve. Just click on the link on the bottom of the page to edit.

---

<div class="post-metadata">

**Author:** ![haydn-cahir-rio](https://avatars.discourse-cdn.com/v4/letter/h/b5a626/32.png) [@haydn-cahir-rio](https://developer.sailpoint.com/discuss/u/haydn-cahir-rio)\
**Post date:** [March 14, 2023, 2:12pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/9 "2023-03-14T14:12:25Z")

</div>

Hi Philip,

I would be happy to add something to that page but unfortunately I am not sure how to define some of those types. For example they “keyValue” type. I am assuming the spec file requires the options to be defined like:

```auto
"AllowedValues": {
	"Option": {
		"label": "Item",
		"value": "item"
	}
},

```

But that format causes an error when uploading the distribution file. Is the publicly available schema I can reference to get the types to work?

Cheers

---

<div class="post-metadata">

**Author:** ![philip-ellis](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/philip-ellis/32/502_2.png) [@philip-ellis](https://developer.sailpoint.com/discuss/u/philip-ellis)\
**Post date:** [March 15, 2023, 2:56pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/10 "2023-03-15T14:56:41Z")

</div>

Good point there! I will be looking into this in the next couple of weeks to resolve for those more complex types. I don’t think there is a publicly available source for the data model behind those.

---

<div class="post-metadata">

**Author:** ![Carlatto](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/carlatto/32/4764_2.png) [@Carlatto](https://developer.sailpoint.com/discuss/u/Carlatto)\
**Post date:** [April 15, 2023, 1:58pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/11 "2023-04-15T13:58:10Z")

</div>

Do you know when we can expect this documentation?

I am creating a connector where I would like to list out some options that a user can multi-select what options they want. I can use a List config type, but the source is picky about case and options not existing. So it would be better to control the input more than having a free form List.

---

<div class="post-metadata">

**Author:** ![philip-ellis](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/philip-ellis/32/502_2.png) [@philip-ellis](https://developer.sailpoint.com/discuss/u/philip-ellis)\
**Post date:** [April 17, 2023, 12:25pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/12 "2023-04-17T12:25:24Z")

</div>

I will be looking into adding it this week most likely.

---

<div class="post-metadata">

**Author:** ![philip-ellis](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/philip-ellis/32/502_2.png) [@philip-ellis](https://developer.sailpoint.com/discuss/u/philip-ellis)\
**Post date:** [April 20, 2023, 2:11pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/13 "2023-04-20T14:11:58Z")

</div>

Documentation now includes examples for all the complex input attributes. You can find them all here: [Connector Specification File | SailPoint Developer Community](https://developer.sailpoint.com/idn/docs/saas-connectivity/connector-spec)

---

<div class="post-metadata">

**Author:** ![Carlatto](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/carlatto/32/4764_2.png) [@Carlatto](https://developer.sailpoint.com/discuss/u/Carlatto)\
**Post date:** [April 20, 2023, 2:41pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/14 "2023-04-20T14:41:39Z")

</div>

Great, thank you! Is it possible to pre-populate the List?

---

<div class="post-metadata">

**Author:** ![Carlatto](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/carlatto/32/4764_2.png) [@Carlatto](https://developer.sailpoint.com/discuss/u/Carlatto)\
**Post date:** [April 20, 2023, 4:12pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/15 "2023-04-20T16:12:45Z")

</div>

The documentation is very helpful. Especially the parentKey and parentValue for hiding fields until they are needed.

---

<div class="post-metadata">

**Author:** ![system](https://global.discourse-cdn.com/sailpoint/original/2X/f/f2136700ed5e3703e0b85e02f6be799dacca7735.png) [@system](https://developer.sailpoint.com/discuss/u/system)\
**Post date:** [July 19, 2023, 2:24pm UTC](https://developer.sailpoint.com/discuss/t/problem-with-connector-spec-json/8658/16 "2023-07-19T14:24:26Z")

</div>


